Thumbnailator缩放不准确因混淆scale()（等比）与size()（强制拉伸）；裁剪需先sourceRegion()再size()；大图应预读BufferedImage防OOM；outputQuality()仅对JPG生效且须用float型0.0–1.0值。
Thumbnailator 缩放图片时尺寸不准确？检查 scale() 和 size() 的语义区别
缩放结果和预期不符，往往是因为混淆了「等比缩放」和「强制拉伸」两种行为。scale() 是按比例缩放（比如 scale(0.5) 缩为原图 50%），而 size() 是强制设定输出宽高（比如 size(200, 150) 会直接拉伸或裁剪到该尺寸，不保比例）。
常见错误：想把大图等比缩到宽度 300 像素，却写了 size(300, Thumbnails.AUTOMATIC) —— 这其实没问题；但若写成 size(300, 300) 就会失真。更稳妥的做法是用 scale(300.0 / originalWidth) 或直接用 width(300).keepAspectRatio(true)。
-
Thumbnails.of(input).size(300, 200)：强制输出 300×200，可能变形 -
Thumbnails.of(input).width(300).keepAspectRatio(true)：宽度固定为 300，高度自动计算，保持比例 -
Thumbnails.of(input).scale(0.3)：所有边等比缩为 30%，适合批量处理未知尺寸图
裁剪图片前必须先 sourceRegion()，否则 crop() 不生效
Thumbnailator 的裁剪不是靠 crop() 单独完成的，它只是「指定裁剪区域」的动作，真正执行依赖前置的 sourceRegion()。漏掉这步，代码能跑、没报错，但图片完全不变。
典型场景：头像裁剪（取原图中间 200×200 区域）。注意 Coordinates 是从左上角 (0,0) 开始算的，不是居中逻辑自动推导。
立即学习“Java免费学习笔记（深入）”；
- 错误写法：
Thumbnails.of(img).crop(Positions.CENTER).size(200, 200)——crop()在 Thumbnailator 4.x+ 已废弃，且无sourceRegion()时无效 - 正确写法：
Thumbnails.of(img).sourceRegion(Positions.CENTER, 200, 200).size(200, 200) - 自定义坐标裁剪：
.sourceRegion(50, 100, 300, 200)表示 x=50, y=100, width=300, height=200 的矩形区域
内存溢出或处理慢？别让 Thumbnails.of() 直接读大文件流
传入 File 或 InputStream 给 Thumbnails.of() 时，Thumbnailator 默认会全量加载进内存解码——一张 5000×4000 的 JPEG 可能瞬间占掉 200MB+ 堆内存，尤其在 Web 服务里并发几路就 OOM。
解决核心：用 ImageIO.read() 预控制解码过程，或改用带缓冲的 BufferedImage 构造方式。
- 避免：
Thumbnails.of(new FileInputStream("big.jpg")) - 推荐：
BufferedImage src = ImageIO.read(new File("big.jpg"));，再传给Thumbnails.of(src) - 对超大图，可先用
ImageReader获取原始尺寸，判断是否需要降采样再读全图 - 注意：
ImageIO.read()对某些 CMYK JPEG 会失败，需额外加com.twelvemonkeys.imageio支持
输出质量模糊或发虚？outputQuality() 必须配合 outputFormat("jpg")
outputQuality(0.9) 只对 JPEG 生效，PNG 和 GIF 完全忽略这个参数。很多人设了 0.95 还是糊，其实是输出成了 PNG（默认格式），压根没走压缩逻辑。
另一个坑：质量值是 float 类型，范围 0.0–1.0，写成 95 或 "0.95" 都会触发默认值（通常是 0.8），且不报错。
- 确保 JPG 输出：
.outputFormat("jpg").outputQuality(0.92f) - PNG 不支持有损压缩，如需小体积，得用其他库（如 PNGEncoder）或转 WebP
- 实测：0.85–0.92 是画质/体积较优区间；低于 0.75 文字边缘开始明显锯齿
最易被忽略的一点：Thumbnailator 不做颜色空间转换，输入是 sRGB 就输出 sRGB，但某些相机直出图带 Adobe RGB 配置文件，浏览器渲染会偏色——这不是 Thumbnailator 的问题，但排查时容易误判。
