Java初学者项目实战：实现一个基础的图像处理工具

Java图像处理需手动防范ImageIO静默失败、像素类型不匹配、色彩空间误用等坑：读图须判null，操作前转TYPE_INT_ARGB，灰度化用加权公式，PNG保存注意大小写及alpha通道。

Java 自带的 javax.imageio 和 java.awt

.image 足够完成基础图像处理，不需要额外依赖库。但直接操作像素数组、处理色彩空间、应对不同格式（如 PNG 透明通道、JPEG YCbCr 解码）容易出错——关键不在“能不能做”，而在“怎么避免踩坑”。

用 ImageIO.read() 读图时为什么常返回 null？

这不是代码写错了，而是 ImageIO.read() 在遇到不支持的编码、损坏头信息、或输入流已关闭时静默失败，只返回 null。它不会抛异常，也不告诉你哪里不对。

• 务必检查返回值：BufferedImage img = ImageIO.read(file); if (img == null) throw new IllegalArgumentException("无法加载图像: " + file);
• 优先用 File 或 Path 构造参数，避免传入已关闭的 InputStream
• JPEG 文件若含 Adobe RGB 或 CMYK 色彩配置文件，ImageIO 可能拒绝加载；可先用 filetype 命令或十六进制查看前几个字节确认是否真为 JPEG（FF D8 FF）

修改像素前必须确保图像是 TYPE_INT_ARGB 或 TYPE_INT_RGB

BufferedImage 有十几种 getType()，但只有 TYPE_INT_ARGB、TYPE_INT_RGB 等“整数型”类型才支持直接调用 getRGB()/setRGB()。其他类型（如 TYPE_BYTE_BINARY 或 TYPE_USHORT_GRAY）会抛 ArrayIndexOutOfBoundsException 或静默失效。

• 安全做法：统一转为目标类型
  

  BufferedImage safeImg = new BufferedImage(
      src.getWidth(), src.getHeight(),
      BufferedImage.TYPE_INT_ARGB
  );
  safeImg.getGraphics().drawImage(src, 0, 0, null);

• 灰度化时别直接改 RGB 值——要先提取亮度分量：int gray = (r * 299 + g * 587 + b * 114) / 1000;（YUV 加权公式）
• 透明通道（alpha）需单独处理：对 TYPE_INT_ARGB，getRGB(x,y) 返回值是 0xAARRGGBB，提取 alpha 要用 (rgb >> 24) & 0xFF

保存 PNG 时透明背景变黑？

这是最典型的色彩模型误用：把 TYPE_INT_RGB（无 alpha 通道）的图像强行保存为 PNG，JVM 会丢弃 alpha 信息，并将原透明区域渲染为黑色（因 RGB 类型默认 alpha=0，但显示时按不透明解释）。

• 保存前检查：if (img.getType() != BufferedImage.TYPE_INT_ARGB) { /* 转换 */ }
• PNG 写入必须用 ImageIO.write(img, "PNG", output)，不能写成 "png"（大小写敏感，小写会失败且无提示）
• 如果原始图没有透明需求，但想保留白底，可在绘制前清空背景：Graphics2D g = img.createGraphics(); g.setColor(Color.WHITE); g.fillRect(0, 0, img.getWidth(), img.getHeight());

真正难的不是算法，而是 Java 图像 API 那些沉默的约定：不报错、不验证、不兼容旧格式、不提示色彩空间差异。每一步读、算、存，都得自己加守门逻辑。