ImageIO.read()返回已解码的BufferedImage，直接调用getWidth()/getHeight()获取真实像素宽高；需判空防NPE，因损坏文件、不支持格式等会导致返回null。

ImageIO.read() 读取图片后怎么拿到宽高

直接调用 BufferedImage 的 getWidth() 和 getHeight() 方法，不是从文件头或元数据里“解析”出来的——ImageIO.read() 返回的就是已解码的图像对象，尺寸是解码后的真实像素值。

• 必须确保 ImageIO.read() 没返回 null，否则调用 getWidth() 会抛 NullPointerException
• 常见错误：传入损坏、不支持格式（如 WebP 在旧 JDK）、路径错或流已关闭的 InputStream，都会导致返回 null
• 示例：

  BufferedImage img = ImageIO.read(new File("test.jpg"));
  if (img != null) {
      int w = img.getWidth();
      int h = img.getHeight();
  }

怎么判断图片格式（不是靠文件扩展名）

ImageIO 本身不提供“读取格式标识”的 API，但可以通过 ImageIO.getImageReadersBySuffix() 或更可靠的方式：用 ImageIO.getImageReaders() 尝试探测输入流前几个字节（即 magic bytes）。

• 依赖文件扩展名（如 "jpg"）可能被篡改，不可信；真正安全的做法是检查二进制头
• JDK 自带的 reader 支持有限：默认支持 "bmp"、"gif"、"jpeg"、"png"、"wbmp"；"webp" 需额外库（如 imageio-webp）
• 简单探测示例（只读前 4 字节）：

  String format = "unknown";
  try (InputStream is = new FileInputStream("test.img")) {
      byte[] header = new byte[4];
      is.read(header);
      if (header[0] == (byte)0xFF && header[1] == (byte)0xD8) format = "jpeg";
      else if (header[0] == 'G' && header[1] == 'I' && header[2] == 'F') format = "gif";
      else if (header[0] == (byte)0x89 && header[1] == 'P' && header[2] == 'N' && header[3] == 'G') format = "png";
  }

为什么 ImageIO.read() 有时很慢或卡住

根本原因在于 ImageIO.read() 是同步、阻塞式解码，且对某些格式（尤其是大 PNG 或含嵌入 ICC Profile 的 JPEG）会触发完整像素解压和色彩空间转换。

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

• 不加超时控制：网络流或损坏文件可能导致线程长时间等待（JDK 8+ 默认无超时）
• 内存压力：大图（如 8000×6000）解码后占大量堆内存，容易触发 GC 甚至 OutOfMemoryError
• 替代方案：若只需尺寸，可用第三方库（如 metadata-extractor）读取 JPEG/PNG 头部，毫秒级完成；或用 ImageReader + setSourceRegion() 跳过像素数据
• 别在主线程或高频接口中直接调用 ImageIO.read() 处理用户上传的任意图片

读取失败时常见的错误信息和对应原因

报错本身不总在 ImageIO.read() 行抛出，常藏在后续操作里，得看堆栈顶层异常类型。

立即学习“Java免费学习笔记（深入）”；

• javax.imageio.IIOException: Can't read input file! → 文件路径不存在、权限不足、或 File 对象指向的是目录
• javax.imageio.IIOException: Unsupported Image Type → 格式不被当前 JVM 支持（如 WebP、HEIC），或图像色深/编码方式特殊（如 CMYK JPEG）
• java.lang.NullPointerException（在调用 getWidth() 后）→ ImageIO.read() 返回了 null，没做判空
• java.io.EOFException → 输入流提前结束，常见于 HTTP 响应未完整接收、或文件被截断

实际项目里最容易被忽略的是：不同 JDK 版本对同一格式的支持程度差异很大（比如 JDK 17 对 AVIF 仍不原生支持），而错误又不总在读取时立即暴露——可能等到缩放、绘制或写回时才崩。别只测 .jpg/.png，上线前务必用真实用户可能上传的边缘格式压测一遍。