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，但显示时按不透明解释）。
立即学习“Java免费学习笔记（深入）”；
- 保存前检查：
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 那些沉默的约定：不报错、不验证、不兼容旧格式、不提示色彩空间差异。每一步读、算、存，都得自己加守门逻辑。
