Java批量压缩图片核心是用ImageIO读取、BufferedImage缩放重采样、ImageWriter控质量；推荐初学者用Thumbnailsator，Maven引入net.coobird:thumbnailator:0.4.20，一行代码实现等比缩放、质量控制与格式转换。
Java 批量压缩图片，核心是用 ImageIO 读取原始图、用 BufferedImage 缩放+重采样、再通过 ImageWriter 控制质量写入新文件。关键在控制压缩质量、保持宽高比、避免内存溢出。
所需依赖（Maven）
基础 Java SE 自带 javax.imageio，无需额外依赖。但若需处理 WebP、HEIC 或更高性能，可选加：
- Thumbnailsator（最常用，语法简洁，自动处理格式/比例/质量）
- Apache Commons Imaging（更底层，支持更多格式）
推荐初学者用 Thumbnailsator，Maven 引入：
net.coobird thumbnailator0.4.20
纯 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();
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;
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();
List images = Arrays.stream(inputDir.listFiles())
.filter(f -> f.isFile() && isImage(f))
.collect(Collectors.toList());
Thumbnails.of(images)
.size(1000, 1000)
.outputQuality(0.75)
.toFiles(outputDir, Rename.PREFIX_DOT_THUMBNAIL); // 生成 thumbnail_xxx.jpg
// 辅助方法
private static boolean isImage(File f) {
String name = f.getName().toLowerCase();
return name.endsWith(".jpg") || name.endsWith(".jpeg") ||
name.endsWith(".png") || name.endsWith(".gif");
}
注意事项与避坑点
实际使用中容易忽略但影响很大：
- 大图（如 >5000×5000）直接加载易 OOM，建议先用
ImageInputStream+ImageReader获取原始尺寸，再按需读取子采样 - 透明 PNG 压缩为 JPG 会丢失 Alpha 通道，需手动填充背景色（如白色）
- Linux 服务器可能缺字体或图形环境，导致
Graphics2D报错，加 JVM 参数：-Djava.awt.headless=true - 并发压缩多图时，避免共用
ImageWriter实例，每个线程应独立获取
基本上就这些。小批量用原生 API 完全够用；中大批量或要快速上线，Thumbnailsator 是更稳更快的选择。
