使用ClassLoader获取资源时触发NullPointerException的原因解析

首先，你遇到的NullPointerException本质是ClassLoader.getSystemResource()没有找到指定的资源，返回了null，后续调用toString()自然就触发异常了。咱们一步步拆解问题，找到解决方案：

一、为什么getResource会返回null？ #

常见原因有这几个：

• 路径写法错误：
  你的资源在src/main/resources/demo/test.txt，编译后这个文件会被放到classpath根目录下的demo文件夹（也就是target/classes/demo/test.txt）。
  • 用ClassLoader.getSystemResource()时，路径不需要开头的/——它默认就是从classpath根目录开始查找的，写了"/demo/test.txt"反而会找不到；正确写法应该是"demo/test.txt"。
  • 还要注意路径大小写：Windows系统不敏感，但Linux/macOS是大小写敏感的，确保文件名和路径拼写完全一致。
• 资源未被正确编译到classpath：
  如果你用Maven/Gradle这类构建工具，要确认src/main/resources被正确标记为资源目录。比如Maven默认会把这个目录下的文件复制到target/classes，但如果你的pom.xml修改过资源配置，可能导致文件没被复制。可以去项目的target/classes目录下看看，有没有demo/test.txt这个文件。
• 类加载器不一致：
  有时候SystemClassLoader和当前项目的类加载器可能不一致（比如Web项目、模块化项目），试试用当前类的类加载器更可靠：YourCurrentClass.class.getClassLoader().getResource("demo/test.txt")。

二、拿到URL后，怎么转成File对象？ #

这里有个关键坑：如果资源最终打包在Jar包里，URL格式会是jar:file:/xxx.jar!/demo/test.txt，这种情况无法直接转成java.io.File——因为Jar里的资源不是本地文件系统的独立文件。

如果资源确实在本地文件系统（比如开发阶段、部署时资源在外部目录），可以这样转换：

URL resourceUrl = ClassLoader.getSystemResource("demo/test.txt");
if (resourceUrl != null) {
    // 仅处理本地文件协议的URL
    if ("file".equals(resourceUrl.getProtocol())) {
        try {
            File file = new File(resourceUrl.toURI());
            // 后续可正常使用这个file对象
        } catch (URISyntaxException e) {
            e.printStackTrace();
        }
    } else {
        System.out.println("资源不在本地文件系统，无法创建File对象");
    }
} else {
    System.out.println("未找到指定资源");
}

三、更通用的替代方案：不需要File对象的场景 #

如果你的目标只是读取资源内容，其实不需要转成File，直接用InputStream更通用（不管资源在本地还是Jar里都能读取）：

InputStream inputStream = ClassLoader.getSystemResourceAsStream("demo/test.txt");
if (inputStream != null) {
    try (BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream))) {
        String line;
        while ((line = reader.readLine()) != null) {
            // 处理读取到的内容
            System.out.println(line);
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}

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