Java ImageReader 怎样只读取图片尺寸而不解码整图

如果只是为了校验上传图片的宽高，直接调用 ImageIO.read(file) 往往做多了一步：它会返回一个完整的 BufferedImage。Java Image I/O 提供了更窄的入口，先取得能识别输入的 ImageReader，再调用 getWidth(0) 和 getHeight(0) 查询第 0 幅图片的尺寸，整个过程不需要创建整幅像素图。

官方资料：https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/imageio/ImageReader.html

这篇只讨论“读取尺寸”这个边界：输入可以是本地文件或其他能创建 ImageInputStream 的对象，代码不负责缩放、转码和读取像素内容。

为什么 ImageIO.read 不是尺寸查询

ImageIO.read 的返回值是 BufferedImage，它适合后续要访问像素、绘制或转换格式的场景。若业务只需要在入库前判断图片比例，创建完整图像会引入不必要的内存对象，也让“尺寸检查”和“像素解码”混在一起。

ImageReader 的职责更细：设置输入后，它既能读取图像，也提供 getWidth、getHeight、getImageMetadata 等查询方法。这里不调用 read，只查询第 0 个图像索引。

先从输入中找到合适的 ImageReader

不要根据文件名后缀手工写一串格式分支。ImageIO.createImageInputStream 会把文件包装成 Image I/O 可用的输入流，ImageIO.getImageReaders(input) 再返回当前注册、声称能够解析该输入的 reader 迭代器。

import javax.imageio.ImageIO;
import javax.imageio.ImageReader;
import javax.imageio.stream.ImageInputStream;
import java.io.File;
import java.io.IOException;
import java.util.Iterator;

public final class ImageSizeReader {
    public static int[] readSize(File file) throws IOException {
        // ImageInputStream 负责给 ImageReader 提供可定位的输入。
        try (ImageInputStream input = ImageIO.createImageInputStream(file)) {
            if (input == null) {
                throw new IOException("无法创建图片输入流");
            }

            Iterator readers = ImageIO.getImageReaders(input);
            if (!readers.hasNext()) {
                throw new IOException("没有找到可识别该图片的 ImageReader");
            }

            ImageReader reader = readers.next();
            try {
                // true 表示只向前读取；true 允许读取尺寸时忽略元数据。
                reader.setInput(input, true, true);
                int width = reader.getWidth(0);
                int height = reader.getHeight(0);
                return new int[] {width, height};
            } finally {
                // ImageReader 不是 AutoCloseable，需要显式释放插件资源。
                reader.dispose();
            }
        }
    }
}

这段代码的关键点是返回宽高后仍然会执行 finally。没有 reader 时直接抛出异常，避免后面出现难以定位的空迭代器问题；ImageInputStream 则交给 try-with-resources 关闭。

getWidth 和 getHeight 查询的是哪一张图

getWidth(0) 与 getHeight(0) 中的 0 是图像索引，不是缩放比例。普通单帧 JPEG、PNG 使用索引 0 就够了；GIF、TIFF 等可能包含多帧或多幅图像时，索引代表输入中的不同图像，不能把“第 0 幅”误解成“整份文件”。

如果业务只验证首帧上传尺寸，保持索引 0 最直接。如果业务必须检查动画每一帧，应先明确是否允许扫描后续索引，再设计遍历策略；不要为了拿宽高调用 getNumImages(true)，因为它可能需要搜索整个输入。

同时，setInput(input, true, true) 的两个布尔参数有不同含义：第一个限制为向前读取，第二个允许 reader 忽略元数据。只查尺寸时这样设置可以表达更窄的需求；如果后面还要调用 getImageMetadata，就把第三个参数改为 false，并按插件能力处理返回值。

资源边界和兼容处理要分开看

“不解码整图”不等于“完全不读取文件”。reader 仍可能读取格式头或必要的索引数据，具体读取范围由图片格式和插件实现决定。能确定的是：示例没有调用返回 BufferedImage 的 read，调用方也没有把整张像素数据保留在堆内存中。

还要注意三件事：

• 输入类型：多数标准 reader 接受的是 ImageInputStream，不要把任意 InputStream 直接传给 setInput。
• 插件缺失：没有 reader 不代表图片一定损坏，也可能是当前运行时没有对应格式插件；应记录清楚异常上下文。
• reader 生命周期：每次从迭代器取得的 reader 都要在使用后调用 dispose()，输入流也要关闭，尤其是批量处理上传文件时。

几个容易混淆的问题

是否可以只用文件后缀判断宽高？

不建议。后缀只能作为业务层提示，实际解析仍应交给 Image I/O 的 reader 选择机制；上传文件可能改名，后缀也未必与内容一致。

调用 getWidth 后还能继续 read 吗？

通常可以，只要输入和 reader 仍处于可用状态，并且没有因为 seekForwardOnly 约束访问已经越过的索引。若当前任务只是校验尺寸，查询完成后直接释放资源更清晰。

什么时候仍然应该使用 ImageIO.read？

当后续确实需要访问像素、读取颜色、绘制缩略图或交给其他图像处理 API 时，再使用 read。不要为了“顺手拿尺寸”提前承担整图解码。

小结

Java ImageReader 的尺寸查询路径可以压缩成四个动作：创建 ImageInputStream、选择 reader、调用 setInput、读取 getWidth(0) 和 getHeight(0)。只查尺寸时不调用 read，需要元数据时关闭忽略选项，并始终释放 reader 与输入流，就能把尺寸校验和整图解码拆成两个清楚的责任边界。