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)会触发完整像素解压和色彩空间转换。
- 不加超时控制:网络流或损坏文件可能导致线程长时间等待(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 响应未完整接收、或文件被截断










