imageio是java标准库中轻量图像处理工具，支持从字节数组、输入流等动态来源读取图片，通过bufferedimage中转实现格式转换，但不支持webp且gif仅读首帧。
ImageIO 是 Java 标准库中轻量、无需额外依赖的图像处理工具，适合处理变量图片（即路径/字节数组/输入流等动态来源）的读取、写入和格式转换。关键在于灵活使用 ImageIO.read() 和 ImageIO.write()，配合 BufferedImage 中转，避开硬编码路径。
支持变量来源的图片读取
ImageIO 可从 File、InputStream、URL 或字节数组（需包装为 ByteArrayInputStream）读取。只要能转成标准输入源，就能加载任意来源的图片。
- 从字节数组读取：byte[] imgBytes = ...; BufferedImage img = ImageIO.read(new ByteArrayInputStream(imgBytes));
- 从 HTTP 响应流读取：BufferedImage img = ImageIO.read(httpResponse.getInputStream());
- 注意：若输入流已被读取过（如调用过
available()或部分read()），需重置（mark()/reset()）或重新获取流，否则返回null
统一用 BufferedImage 中转实现格式转换
ImageIO 本身不直接“转换格式”，而是先解码为 BufferedImage，再以目标格式编码写出。这是安全、兼容性高的通用做法。
- 读入任意格式（JPEG/PNG/GIF/BMP）→ 得到
BufferedImage - 写出时指定格式名（如
"png"、"jpg"），自动选择对应ImageWriter - 示例：将上传的 JPEG 字节数组转为 PNG 输出流：ImageIO.write(bufferedImage, "png", outputStream);
写入时控制质量与透明度
默认 ImageIO.write() 对 JPEG 不支持质量调节，对 PNG 不控制压缩级别。需借助 ImageWriter 和 IIOImage 手动配置。
- JPEG 质量控制（0.1–1.0）：ImageWriter writer = ImageIO.getImageWritersByFormatName("jpeg").next(); writer.setOutput(outputStream); JPEGImageWriteParam param = (JPEGImageWriteParam) writer.getDefaultWriteParam(); param.setCompressionMode(ImageWriteParam.MODE_EXPLICIT); param.setCompressionQuality(0.85f); writer.write(null, new IIOImage(bufferedImage, null, null), param);
- PNG 透明通道保留：确保原图是
TYPE_INT_ARGB，且写入格式为"png"，默认自动保留 Alpha
常见陷阱与绕过建议
ImageIO 功能简洁但限制明显，遇到问题优先确认是否属于已知局限。
-
不支持 WebP（JDK 17 及更早版本）：需引入
webp-imageio等第三方插件，或改用TwelveMonkeys ImageIO -
GIF 动画只读首帧：
ImageIO.read()返回静态图；需用ImageReader逐帧解析 - 读取失败静默返回 null：务必检查返回值，避免 NPE；可加日志输出原始流长度或前几个字节（Magic Number）辅助诊断
