Java批量导入图片至BufferedImage数组时遇空指针异常

问题概述 #

需要将项目类路径下/res/moon/目录中的60张图片导入到BufferedImage数组中，单张图片导入代码可正常运行，但批量导入时在new File("/res/moon/").listFiles().length处触发NullPointerException，提示Cannot read the array length because the return value of "java.io.File.listFiles()" is null。

错误原因 #

new File("/res/moon/")是尝试访问本地文件系统的绝对路径，但你的图片是存储在项目的类路径资源目录中（通常是src/main/resources下的目录，编译后会打包到JAR或编译输出目录），并非本地文件系统的独立目录。因此File无法找到该路径，listFiles()返回null，调用length()时自然抛出空指针异常。

而单张导入时使用的getClass().getResourceAsStream()是正确的方式——它从类路径中加载资源，不受文件系统路径的限制。

修复方案 #

方案1：已知图片数量时直接循环（简单可靠） #

既然已经确定有60张图片（文件名从1.png到60.png），可以直接指定数量循环加载，避免遍历目录的问题，同时优化流的关闭逻辑：

private void importImgs() {
    int numImgs = 60;
    moonIdle = new BufferedImage[numImgs];

    // 循环遍历1到60，对应文件名1.png至60.png
    for (int i = 1; i <= numImgs; i++) {
        String resourcePath = "/res/moon/" + i + ".png";
        // 使用try-with-resources自动关闭输入流，无需手动finally处理
        try (InputStream is = getClass().getResourceAsStream(resourcePath)) {
            if (is == null) {
                System.err.println("无法找到资源文件: " + resourcePath);
                continue;
            }
            // 数组索引从0开始，所以用i-1对应位置
            moonIdle[i - 1] = ImageIO.read(is);
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }
}

关键修复点：

1. 直接使用已知的图片数量60，避免通过File遍历目录。
2. 循环从1到60，确保文件名匹配1.png到60.png（原代码中i + 1会导致01.png这类错误文件名）。
3. 使用try-with-resources语法自动关闭InputStream，简化代码并避免资源泄漏。
4. 增加InputStream为null的判断，提前处理资源找不到的情况。

方案2：动态遍历类路径资源（兼容JAR打包场景） #

如果需要动态识别图片数量，且项目可能打包成JAR运行，需要兼容类路径资源的两种访问方式（本地文件系统、JAR包内）：

private void importImgs() {
    List<BufferedImage> imageList = new ArrayList<>();
    String dirPath = "/res/moon/";
    URL dirUrl = getClass().getResource(dirPath);

    if (dirUrl == null) {
        System.err.println("资源目录不存在: " + dirPath);
        return;
    }

    try {
        if ("file".equals(dirUrl.getProtocol())) {
            // 本地开发环境，目录在文件系统中
            File dir = new File(dirUrl.toURI());
            File[] imageFiles = dir.listFiles(file -> file.getName().toLowerCase().endsWith(".png"));
            if (imageFiles != null) {
                // 按文件名排序（确保1.png到60.png的顺序）
                Arrays.sort(imageFiles, Comparator.comparingInt(f -> Integer.parseInt(f.getName().replace(".png", ""))));
                for (File file : imageFiles) {
                    try (InputStream is = new FileInputStream(file)) {
                        imageList.add(ImageIO.read(is));
                    }
                }
            }
        } else if ("jar".equals(dirUrl.getProtocol())) {
            // 打包成JAR文件，读取JAR内的资源
            String jarPath = dirUrl.getPath().substring(5, dirUrl.getPath().indexOf("!"));
            try (JarFile jarFile = new JarFile(jarPath)) {
                Enumeration<JarEntry> entries = jarFile.entries();
                List<JarEntry> pngEntries = new ArrayList<>();
                while (entries.hasMoreElements()) {
                    JarEntry entry = entries.nextElement();
                    String entryName = entry.getName();
                    if (entryName.startsWith(dirPath.substring(1)) && entryName.toLowerCase().endsWith(".png")) {
                        pngEntries.add(entry);
                    }
                }
                // 按文件名排序
                pngEntries.sort(Comparator.comparingInt(e -> Integer.parseInt(e.getName().replace(dirPath.substring(1), "").replace(".png", ""))));
                for (JarEntry entry : pngEntries) {
                    try (InputStream is = jarFile.getInputStream(entry)) {
                        imageList.add(ImageIO.read(is));
                    }
                }
            }
        }
    } catch (URISyntaxException | IOException ex) {
        ex.printStackTrace();
    }

    moonIdle = imageList.toArray(new BufferedImage[0]);
}

说明：

• 该方案同时支持本地开发和JAR运行场景，自动识别资源的存储方式。
• 增加了文件名排序逻辑，确保图片按1.png到60.png的顺序加载。

内容的提问来源于stack exchange，提问作者Klevergaard