imageio.read()不支持webp/heic等格式因默认插件缺失，需引入jai-imageio-webp并调用scanforplugins()；写png透明背景变黑须确保bufferedimage为type_int_argb；批量处理需flush()防oom；gif动画需用imagewriter手动写帧序列。
ImageIO.read() 读不出 WebP 或 HEIC 图片
Java 原生 ImageIO 默认只支持 JPEG、PNG、GIF、BMP 和 WBMP，WebP、HEIC、AVIF 等现代格式会直接返回 null，不报错也不提示——这是最常被忽略的“静默失败”。
解决方法不是换库，而是先确认当前 JVM 是否已注册对应插件：
- 用
ImageIO.getReaderFormatNames()打印支持列表，确认是否有"webp"或"heic" - 若没有，需手动引入第三方 reader，比如
com.github.jai-imageio:jai-imageio-webp（Maven），它会在类路径下自动注册WebPImageReaderSpi - 注意：JDK 9+ 的模块系统可能屏蔽 SPI 自动加载，建议显式调用
ImageIO.scanForPlugins()触发重扫描
ImageIO.write() 输出透明 PNG 时背景变黑
常见于从 JPG（无 alpha）转 PNG 时，ImageIO.write() 会把原始 BufferedImage 的类型硬编码为 TYPE_INT_RGB，丢弃 alpha 通道或用黑色填充透明区域。
关键不是改参数，而是确保输入图像本身带 alpha 且类型正确：
立即学习“Java免费学习笔记（深入）”；
- 用
bufferedImage.getType() == BufferedImage.TYPE_INT_ARGB检查；如果不是，用new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB)创建新画布 - 用
Graphics2D把原图绘制到新画布上，避免直接 copy 数据 - 写入前确认目标格式是
"png"（小写），ImageIO.write()对大小写敏感，"PNG"会失败并静默返回false
批量转换时内存爆掉，GC 不及时
ImageIO.read() 返回的 BufferedImage 占用大量堆外内存（尤其大图），而 Java 8 及以前版本中，这些资源不随对象 GC 自动释放，容易 OOM。
必须主动管理生命周期：
- 每处理完一张图后，立即调用
bufferedImage.flush()，清空像素数据缓存 - 避免长期持有
BufferedImage引用，用完即置null - 对超大图（如 >5000×5000），改用
ImageInputStream+ 分块解码，而不是一次性read() - 别依赖
System.gc()，它不可靠；重点是flush()+ 及时断引用
输出 GIF 动画丢失帧或变静态
ImageIO.write() 原生不支持多帧 GIF 写入，只会写入第一帧。想保留动画，必须用 ImageWriter API 手动控制帧序列。
步骤很固定，但漏一步就退化成单帧：
- 用
ImageIO.getImageWritersByFormatName("gif")获取ImageWriter实例 - 调用
writer.setOutput(ImageIO.createImageOutputStream(outputStream)) - 对每一帧调用
writer.writeToSequence(new IIOImage(frame, null, metadata), param)，其中metadata必须包含延迟时间（GraphicControlExtension） - 最后一帧后必须调用
writer.endWriteSequence()，否则文件损坏
真正难的不是代码，是理解 ImageIO 的 writer 是有状态的——它不像 read 那样“一次一图”，而是需要显式开启/追加/关闭序列。
