ImageIO.read() 返回 null 或抛 IOException 主因是格式不支持（如 WebP）、文件损坏或输入流关闭；缩放模糊需设抗锯齿与双三次插值；中文水印乱码应查可用字体并用 getStringBounds 计算尺寸；内存暴增源于 BufferedImage native 数据未及时回收，须置空引用并调用 dispose()。
ImageIO.read() 读取图像时抛出 IOException 或返回 null
常见现象是代码看似正常，但 ImageIO.read() 返回 null，或直接抛出 IOException: Can't read input file!。根本原因不是文件路径错，而是 ImageIO 不支持某些编码格式（如 WebP）、损坏文件、或输入流被提前关闭。
- 确保文件存在且有读权限，用
new File(path).exists()先验证 - 避免传入已关闭的
InputStream；若从资源加载，优先用ImageIO.read(getClass().getResourceAsStream("/xxx.png")) - 不支持 WebP / HEIC 等格式 —— JDK 8/11 原生
ImageIO只认png、jpg、gif（部分版本支持bmp），其他格式需额外插件（如imageio-webp） - 遇到
null时，立刻检查ImageIO.getReaderFormatNames()输出，确认当前 JVM 支持哪些格式
用 Graphics2D 缩放图像时出现锯齿或模糊
直接调用 g2d.drawImage(img, x, y, width, height, null) 缩放，容易糊成一片或边缘生硬。这不是代码写错，而是默认渲染质量太低。
- 必须开启抗锯齿和高质量插值：
g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC);<br>g2d.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);<br>g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
- 缩放比例过大（如 >3×）时，建议分步缩放：先缩到中间尺寸，再缩到目标，比一步到位清晰得多
- 不要在缩放后还用原图宽高计算坐标 —— 务必用新生成的
BufferedImage的getWidth()/getHeight()
添加文字水印后中文乱码或位置偏移
水印文字显示为方块、问号，或始终贴左上角不动，问题通常出在字体加载和坐标计算上。
- 别依赖系统默认字体：
new Font("SimSun", Font.PLAIN, 12)在 Linux/macOS 上大概率失败；改用Font.decode("sans-bold-12")或先用GraphicsEnvironment.getLocalGraphicsEnvironment().getAllFonts()查可用字体 - 水印位置用
font.getStringBounds(text, frc)算真实宽高，别信font.getSize()—— 中文下 ascender/descender 差异大 - 设置
g2d.setColor(new Color(255, 255, 255, 128))控制透明度，alpha 值 0–255，别传 0.5 这种浮点数（会全黑）
内存暴增与 BufferedImage 泄漏
批量处理图像（比如生成缩略图+加水印）时，JVM 内存持续上涨，GC 无效，最终 OutOfMemoryError: Java heap space。根源是 BufferedImage 底层持有 native pixel 数据，不显式干预不会被及时回收。
立即学习“Java免费学习笔记（深入）”；
- 每次操作完，手动置空引用：
originalImage = null;、tempBufImg = null; - 避免在循环里反复
getGraphics()却不dispose()—— 每个Graphics2D必须配对调用g2d.dispose() - 大图处理前先用
ImageIO.read()读元信息（宽高），判断是否需要采样缩放再加载全图，用ImageReader+ImageReadParam.setSourceSubsampling()可省 70% 内存
真正麻烦的是多线程共用 Graphics2D 或静态缓存 BufferedImage —— 这类共享状态一旦没同步好，图像会错位、丢色、甚至崩溃，比内存问题更难定位。
