Java/Scala中列出Resources文件夹所有文件及空指针异常排查

嘿，我来帮你搞定这个空指针的问题～你遇到的情况大概率是因为File类没法正确处理JAR包中的资源路径，或者资源路径的加载逻辑有问题，下面给你拆解原因和解决方向：

为什么会出现空指针？ #

主要有两个常见原因：

1. getResource()返回null：说明你的资源路径不对，或者编译/打包时images/sprites目录没被正确放到classpath里。
2. 资源在JAR包中，File无法识别路径：当代码打包成JAR后，getResource("/images/sprites")返回的URL格式是jar:file:/xxx.jar!/images/sprites，这种路径不是文件系统的真实路径，用new File()创建对象后，listFiles()自然会返回null甚至抛出异常。

一步步排查解决 #

第一步：先确认资源是否能被正确加载 #

先加一行代码打印资源URL，看看是不是null：

URL spriteDirUrl = getClass().getResource("/images/sprites");
System.out.println("资源URL：" + spriteDirUrl);

• 如果输出null：检查你的Resources目录是否被IDE标记为Resources Root（比如IDEA里右键目录→Mark Directory as→Resources Root），确保打包后images/sprites目录确实在classpath根目录下。
• 如果输出类似file:/xxx/classes/images/sprites（开发阶段）：继续下一步；如果输出jar:file:/xxx.jar!/images/sprites（打包后）：必须用JAR资源的遍历方式。

第二步：处理文件系统中的资源（开发阶段） #

如果是开发阶段，资源在本地文件系统中，可能是getPath()的编码问题（比如路径含空格会被转成%20），需要解码后再创建File对象：

String path = URLDecoder.decode(spriteDirUrl.getPath(), StandardCharsets.UTF_8.name());
File[] files = new File(path).listFiles();
// 之后再处理files，记得判空哦
if (files != null) {
    for (File file : files) {
        // 加载符合条件的文件
    }
}

第三步：处理JAR包中的资源（打包后） #

这时候File类彻底失效，得用Java NIO的FileSystem来遍历JAR内的目录，示例代码如下：

try {
    URI uri = spriteDirUrl.toURI();
    Path spritePath;

    if (uri.getScheme().equals("jar")) {
        // 打开JAR文件系统
        FileSystem jarFs = FileSystems.newFileSystem(uri, Collections.emptyMap());
        spritePath = jarFs.getPath("/images/sprites");
    } else {
        // 本地文件系统直接用Paths
        spritePath = Paths.get(uri);
    }

    // 遍历目录下的所有文件
    Files.walk(spritePath)
         .filter(Files::isRegularFile) // 只处理文件，排除目录
         .forEach(file -> {
             // 这里加载符合条件的文件，比如用Files.newInputStream(file)获取输入流
             System.out.println("找到文件：" + file.getFileName());
         });
} catch (URISyntaxException | IOException e) {
    e.printStackTrace();
}

额外注意点 #

• 尽量避免用File类处理classpath资源，尤其是涉及打包的场景，NIO的方式更通用。
• 如果是Spring等框架项目，也可以用ResourceLoader来加载资源，会更省心。

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