Java 後端圖片壓縮最佳實踐：Thumbnailator 實現等比縮放、質量控制、水印、旋轉

移動互聯網時代，手機端流量與加載速度極其敏感。原圖動辄數 MB，直接下發會嚴重拖慢頁面、消耗用戶流量。本文介紹業界推薦的 Thumbnailator 庫，幾行代碼即可實現專業級圖片壓縮與處理。

為什麼需要後端壓縮？

• 流量節省：縮略圖體積僅為原圖 10%~30%，大幅降低 CDN 成本與用戶流量。
• 秒開體驗：列表頁、瀑布流先加載小圖，點擊再載大圖，首屏速度提升數倍。
• 統一標準：後端統一處理，避免前端壓縮兼容性差、性能不一致。

引入依賴

<dependency>
    <groupId>net.coobird</groupId>
    <artifactId>thumbnailator</artifactId>
    <version>0.4.18</version> <!-- 請用最新穩定版 -->
</dependency>

核心功能代碼示例

1. 等比縮放（指定寬/高/最大邊）

// 寬度 200px，高度自適應
Thumbnails.of("input.jpg").size(200, 200).toFile("out_200.jpg");
// 最大邊 300px，保持比例
Thumbnails.of("input.jpg").scale(0.5).toFile("out_half.jpg");

2. 指定輸出質量（0~1）

Thumbnails.of("input.jpg")
    .size(800, 600)
    .outputQuality(0.8) // 80% 質量，體積大幅下降
    .toFile("out_q80.jpg");

3. 添加水印（圖片/文字）

// 圖片水印 右下角 透明度 0.5
Thumbnails.of("input.jpg")
    .size(800, 600)
    .watermark(Positions.BOTTOM_RIGHT,
               ImageIO.read(new File("logo.png")), 0.5f)
    .toFile("out_wm.jpg");

4. 旋轉

Thumbnails.of("input.jpg").rotate(90).toFile("out_rot90.jpg"); // 順時針 90°

5. 綜合鏈式調用

Thumbnails.of(new FileInputStream("src.jpg"))
    .sourceRegion(100, 100, 400, 300) // 裁剪區域
    .size(200, 200)
    .outputFormat("png")
    .outputQuality(0.9)
    .watermark(Positions.CENTER, "© MyApp", 0.3f)
    .toFile("final.png");

性能與生產建議

1. 異步處理：上傳接口立即返回，壓縮任務丟入消息隊列（RabbitMQ/Kafka）由 Worker 消費。
2. 多規格生成：一次上傳同步/異步產出原圖、大圖、中圖、縮略圖，前端按場景按需加載。
3. 格式選擇：照片用 WebP/JPEG，圖標/截圖用 PNG，Thumbnailator 支持 .outputFormat("webp")。
4. 內存保護：大圖處理時設置 -Xmx、使用 Thumbnails.of(InputStream) 避免全量讀入堆內存。
5. 錯誤降級：壓縮失敗記錄日志、返回原圖 URL，不阻塞主流程。

對比：為什麼不推薦 Java Swing (ImageIO)？

• API 繁瑣、需手動計算比例、繪圖上下文管理。
• 無內置水印、旋轉、質量控制等高級功能。
• 性能較差，大圖易 OOM。
• Thumbnailator 底層仍用 ImageIO，但封裝極其優雅、線程安全、持續維護。

掌握 Thumbnailator，讓圖片壓縮從「痛點」變「亮點」，輕松應對高併發圖片業務。