Java Servlet 動態生成圖片完整指南：從繪圖到輸出流的端到端實現

Web 應用中動態生成圖片（驗證碼、統計圖表、實時監控圖、個性化海報）是常見需求。本文詳述基於 HttpServlet 配合 java.awt 繪圖 API，在內存中構建圖像並以 JPEG/PNG 格式直接輸出至 HTTP 響應流的完整實現路徑。

核心原理

瀏覽器請求靜態圖片時，服務器返回標準 HTTP 響應，Content-Type 為 image/jpeg 或 image/png，體為圖片二進制數據。Servlet 動態生成圖片同理：

1. 設置 response.setContentType("image/jpeg")
2. 獲取 response.getOutputStream()
3. 內存繪圖 → 編碼 → 寫入輸出流

步驟詳解與完整代碼

1. 繪圖畫布創建

int width = 400, height = 300;
BufferedImage bi = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);

• TYPE_INT_RGB：24 位 RGB，無透明通道，適合照片、圖表
• TYPE_INT_ARGB：32 位含 Alpha，適合需透明背景的圖層疊加

2. 獲取繪圖上下文

Graphics2D g = bi.createGraphics();

Graphics2D 提供反鋸齒、描邊、填充、仿射變換等高級繪圖能力。

3. 繪圖操作示例

// 背景
g.setBackground(Color.WHITE);
g.clearRect(0, 0, width, height);

// 反鋸齒
g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);

// 繪製圖形
g.setColor(Color.BLUE);
g.fillRect(50, 50, 200, 100);

g.setColor(Color.RED);
g.setFont(new Font("微軟正黑體", Font.BOLD, 24));
g.drawString("動態生成圖片", 80, 120);

// 釋放資源
g.dispose();
bi.flush();

4. 圖像編碼與輸出（關鍵步驟）

方案一：ImageIO 標準 API（推薦，JDK 9+ 兼容）

OutputStream out = response.getOutputStream();
ImageIO.write(bi, "jpeg", out);  // 或 "png"
out.flush();

方案二：JPEGCodec 精細控制品質（舊代碼常見，JDK 內部 API，JDK 9+ 已移除）

JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder(out);
JPEGEncodeParam param = encoder.getDefaultJPEGEncodeParam(bi);
param.setQuality(0.9f, false);  // 0.0~1.0，false=非無損
encoder.setJPEGEncodeParam(param);
encoder.encode(bi);

5. 完整 Servlet 實現

package com.example.web.util;

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.awt.*;
import java.awt.image.*;
import javax.imageio.ImageIO;

public class DynamicImageServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {

        // 1. 設置響應頭
        resp.setContentType("image/jpeg");
        resp.setHeader("Cache-Control", "no-cache, no-store, must-revalidate"); // 防緩存
        resp.setDateHeader("Expires", 0);

        // 2. 業務參數解析（如圖表類型、數據源等）
        String type = req.getParameter("type"); // 可擴展

        // 3. 繪圖
        int w = 600, h = 400;
        BufferedImage image = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
        Graphics2D g = image.createGraphics();
        try {
            renderChart(g, w, h, type);  // 核心繪圖邏輯解耦
        } finally {
            g.dispose();
        }

        // 4. 編碼輸出
        try (OutputStream out = resp.getOutputStream()) {
            ImageIO.write(image, "jpeg", out);
        }
    }

    private void renderChart(Graphics2D g, int w, int h, String type) {
        // 背景
        g.setColor(new Color(0xF5F5F5));
        g.fillRect(0, 0, w, h);

        // 示例：繪製簡單折線圖
        g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
        g.setColor(Color.BLACK);
        g.drawRect(50, 50, w - 100, h - 100); // 座標系邊框

        int[] xData = {100, 180, 260, 340, 420, 500};
        int[] yData = {300, 220, 280, 180, 240, 150};

        g.setColor(Color.BLUE);
        for (int i = 0; i < xData.length - 1; i++) {
            g.drawLine(xData[i], yData[i], xData[i+1], yData[i+1]);
        }
        // 可擴展：坐標軸、刻度、圖例、數據標籤等
    }
}

6. web.xml 註冊

7. 前端調用

進階主題與最佳實踐

高性能繪圖優化

• 對象複用：高併發場景下，考慮 BufferedImage 池化（需線程安全），減少 GC 壓力。
• 異步處理：複雜圖表渲染耗時長，可採用 CompletableFuture 或獨立渲染服務，Servlet 僅返回任務 ID 或重定向。
• 緩存策略：相同參數圖片緩存（Guava Cache / Redis），設置 ETag/Last-Modified 支援條件請求。

字體與中文顯示

• 服務器需安裝目標字體（如 wqy-zenhei、Microsoft YaHei）
• 或打包 TTF 字體檔，運行時 Font.createFont(Font.TRUETYPE_FONT, inputStream) 動態註冊
• Docker 環境注意安裝字體包：apt-get install -y fontconfig fonts-wqy-zenhei

輸出格式選擇

常見坑點避雷

1. 直接用 response.getWriter() 輸出二進制 → 必須用 getOutputStream()
2. 忘記 g.dispose() → 圖形資源洩漏，導致內存耗盡
3. JDK 9+ 使用 com.sun.image.codec.jpeg → 遷移至 ImageIO 或 TwelveMonkeys ImageIO
4. 無 Content-Type → 瀏覽器無法識別圖片類型
5. 大圖直接輸出導致 OOM → 分塊渲染、流式編碼或增加堆內存

1. 上一篇文章： 設計模式實戰：Spring 框架下觀察者模式的優雅實現與解耦實踐
2. 下一篇文章： JDBC 驅動加載與數據庫連接建立機制深度解析

Java 相關知識

Merlin Swing 聽覺反饋：為組件添加聲音提示

聽覺提示架構 J2SE 1.4 Swing 組件可對特定事件

Java 線程池框架深度解析：核心原理與最佳實踐

前言 在 Java 並發編程中，線程池是提升系統性能、控制資

Java SE 數據庫連接操作：JDBC 實現新聞標題 CRUD 完整示例

項目背景 以 MySQL 為例，實現新聞標題表 firstL

Java Applet 開發與執行指南：Eclipse 與 JDK 命令列雙軌實作

⚠️ 歷史技術提示 Java Applet 自 JDK 9