Java批量压缩图片教程及代码实现

本文详细介绍了Java中批量压缩图片的两种主流方案：一是基于原生Java SE的ImageIO、BufferedImage和ImageWriter实现轻量级、无依赖的压缩，涵盖等比缩放、抗锯齿渲染、JPEG质量控制及内存安全处理；二是推荐初学者优先采用Thumbnailsator库，仅需一行链式代码即可优雅完成宽高比保持、多格式自动适配、质量调节与批量目录处理，大幅提升开发效率与代码健壮性；同时指出大图OOM、Alpha通道丢失、Linux图形环境缺失等实战常见坑点及应对策略，助你快速落地高性能、生产可用的图片压缩功能。

Java 批量压缩图片，核心是用 ImageIO 读取原始图、用 BufferedImage 缩放+重采样、再通过 ImageWriter 控制质量写入新文件。关键在控制压缩质量、保持宽高比、避免内存溢出。

所需依赖（Maven）

基础 Java SE 自带 javax.imageio，无需额外依赖。但若需处理 WebP、HEIC 或更高性能，可选加：

• Thumbnailsator（最常用，语法简洁，自动处理格式/比例/质量）
• Apache Commons Imaging（更底层，支持更多格式）

推荐初学者用 Thumbnailsator，Maven 引入：

<dependency>
  <groupId>net.coobird</groupId>
  <artifactId>thumbnailator</artifactId>
  <version>0.4.20</version>
</dependency>

纯 Java 实现（无第三方库）

适合轻量场景，兼容 JDK 8+，不引入新依赖：

• 用 ImageIO.read() 加载图片，注意判空防 NPE
• 按目标宽度/高度等比缩放，避免拉伸变形（建议先计算缩放比例）
• 用 Graphics2D 绘制到新 BufferedImage，开启抗锯齿和双线性插值提升清晰度
• 写入时用 ImageIO.write()，对 JPEG 可通过 JPEGImageWriteParam 设置压缩质量（0.1f ~ 1.0f）

示例：将目录下所有 JPG/PNG 压缩为 80% 质量、最大边 ≤ 1200 像素

File inputDir = new File("src/images");
File outputDir = new File("out/compressed");
outputDir.mkdirs();
<p>for (File src : inputDir.listFiles(f -> f.getName().toLowerCase().endsWith(".jpg") || 
f.getName().toLowerCase().endsWith(".png"))) {
BufferedImage origin = ImageIO.read(src);
if (origin == null) continue;</p><pre class="brush:java;toolbar:false;">int targetWidth = 1200, targetHeight = 1200;
double scale = Math.min((double) targetWidth / origin.getWidth(),
                        (double) targetHeight / origin.getHeight());
int w = (int) Math.round(origin.getWidth() * scale);
int h = (int) Math.round(origin.getHeight() * scale);

BufferedImage resized = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
Graphics2D g = resized.createGraphics();
g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);
g.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
g.drawImage(origin, 0, 0, w, h, null);
g.dispose();

String name = "compressed_" + src.getName();
File dest = new File(outputDir, name.replace(".jpg", ".jpg").replace(".png", ".jpg"));

// JPEG 压缩质量控制
if (dest.getName().endsWith(".jpg")) {
    ImageWriter writer = ImageIO.getImageWritersByFormatName("jpg").next();
    ImageWriteParam param = writer.getDefaultWriteParam();
    param.setCompressionMode(ImageWriteParam.MODE_EXPLICIT);
    param.setCompressionQuality(0.8f);

    FileImageOutputStream out = new FileImageOutputStream(dest);
    writer.setOutput(out);
    writer.write(null, new IIOImage(resized, null, null), param);
    writer.dispose();
    out.close();
} else {
    ImageIO.write(resized, "png", dest);
}

}

用 Thumbnailsator 简化批量压缩

一行代码搞定缩放+质量+格式转换，自动识别输入格式，代码更健壮：

• 支持链式调用：width()/height()/scale()/outputQuality()
• 自动保持宽高比（keepAspectRatio(true) 默认开启）
• 可批量处理文件列表或整个目录（Thumbnails.of(...) 支持 varargs 或 Collection）

示例：压缩目录下所有图片为最大边 1000、质量 0.75、统一输出为 JPG

File inputDir = new File("src/images");
File outputDir = new File("out/thumbs");
outputDir.mkdirs();
<p>List<file> images = Arrays.stream(inputDir.listFiles())
.filter(f -> f.isFile() && isImage(f))
.collect(Collectors.toList());</file></p><p>Thumbnails.of(images)
.size(1000, 1000)
.outputQuality(0.75)
.toFiles(outputDir, Rename.PREFIX_DOT_THUMBNAIL); // 生成 thumbnail_xxx.jpg</p><p>// 辅助方法
private static boolean isImage(File f) {
String name = f.getName().toLowerCase();
return name.endsWith(".jpg") || name.endsWith(".jpeg") || 
name.endsWith(".png") || name.endsWith(".gif");
}</p>

注意事项与避坑点

实际使用中容易忽略但影响很大：

• 大图（如 >5000×5000）直接加载易 OOM，建议先用 ImageInputStream + ImageReader 获取原始尺寸，再按需读取子采样
• 透明 PNG 压缩为 JPG 会丢失 Alpha 通道，需手动填充背景色（如白色）
• Linux 服务器可能缺字体或图形环境，导致 Graphics2D 报错，加 JVM 参数：-Djava.awt.headless=true
• 并发压缩多图时，避免共用 ImageWriter 实例，每个线程应独立获取

基本上就这些。小批量用原生 API 完全够用；中大批量或要快速上线，Thumbnailsator 是更稳更快的选择。

理论要掌握，实操不能落！以上关于《Java批量压缩图片教程及代码实现》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！