ClassLoader.getResource() 返回 null 的根本原因是资源未位于运行时 classpath 的可见路径中，包括：资源未打包进 target/classes 或 JAR、路径误加前导 /、类加载器选择错误（如系统类加载器无法访问应用资源）、IDE 与生产环境 classpath 不一致，以及 Maven 资源配置遗漏或构建未同步。
ClassLoader.getResource() 返回 null 的常见原因
多数情况下 ClassLoader.getResource() 返回 null，不是代码写错了，而是资源没在类路径（Classpath）的**运行时可见位置**。JVM 启动后，ClassLoader 只会扫描它初始化时加载的那些 JAR 和目录——比如 java -cp lib/a.jar:conf/ MyApp 中的 lib/a.jar 和 conf/ 目录；但如果你把文件放在 src/main/resources/config.txt 里却没打包进 JAR 或没加到启动 classpath，它就根本看不见。
- IDE 运行时 classpath ≠ 打包后 JAR 内的 classpath：Maven 构建后，
resources/下文件会被复制到target/classes/，这才是运行时 classpath 的一部分 - 路径开头带
/会触发ClassLoader.getResource()从 classpath 根开始找，不带则相对当前类所在包查找（容易误判） - Spring Boot 的
spring-boot-devtools会额外添加 classpath，但生产 JAR 中没有，导致开发和上线行为不一致
用 ClassLoader.getResourceAsStream() 读取配置文件最稳妥的方式
直接读取字节流比先获取 URL 再打开连接更可靠，避免因 URL 协议（如 jar:、file:）不同引发的异常。尤其当资源在 JAR 包内时，getResource().openStream() 可能抛 NullPointerException，而 getResourceAsStream() 内部做了空值防护。
- 始终用不带前导
/的路径：例如读取config.properties（位于src/main/resources/），传"config.properties"，而非"/config.properties" - 优先使用当前线程上下文类加载器：
Thread.currentThread().getContextClassLoader().getResourceAsStream("logback.xml")，尤其在框架或容器（如 Tomcat、Spring）中，它通常指向应用级 classpath - 不要依赖
MyClass.class.getClassLoader().getResourceAsStream(...)—— 如果MyClass在系统类加载器（Bootstrap/Extension）里，它看不到应用资源
Maven 项目中 resources 目录没生效？检查这几个地方
Maven 默认只把 src/main/resources 复制到 target/classes，但一旦自定义了 build/resources 配置，或者用了 profile 激活不同资源集，就可能漏掉关键文件。
- 确认
pom.xml没禁用默认资源处理：<resources></resources>块里没写<includes><include>**/*.txt</include></includes>却漏了.properties或.xml - 检查 IDE 是否启用 “Build project automatically”：IntelliJ 有时不会自动同步 resources 变更，需手动
Build → Build Project - 运行
mvn clean compile后，打开target/classes/看目标文件是否存在——这是 classpath 的真实来源，不是源码路径
ClassLoader 加载资源时路径与包名的混淆点
很多人以为 MyClass.class.getResource("a.txt") 是在找和 MyClass 同目录的 a.txt，其实它找的是 com/example/MyClass.class 所在包路径下的 com/example/a.txt。这个“相对”是按包结构算的，不是文件系统层级。
-
MyClass.class.getResource("a.txt")→ 查找com/example/a.txt -
MyClass.class.getResource("../a.txt")→ 查找com/a.txt（向上跨一级包） -
MyClass.class.getResource("/a.txt")→ 查找 classpath 根目录下的a.txt（等价于getClassLoader().getResource("a.txt")） - 如果资源在
src/main/resources/static/js/app.js，正确路径是"static/js/app.js"，不是"js/app.js"或"/static/js/app.js"
System.out.println(Thread.currentThread().getContextClassLoader().getResource("")) 打印出 classpath 根 URL，再对照看文件位置。这点被跳过，后面所有调试都是在猜。 
