ClassLoader.getSystemResource() 从 classpath 查找资源，不直接访问项目根路径；需确保文件在 src/main/resources 或显式添加的 classpath 中，否则无法加载。
在 Java 中，ClassLoader.getSystemResource() 本质上是通过系统类加载器（即 AppClassLoader）查找资源，它**不会直接访问项目根路径（如 IDEA 中的 ./ 或 Maven 的 src/main/resources 上级目录）**，而是从类路径（classpath）中查找。因此，“项目根路径下的静态配置文件”若未被包含进 classpath，就无法用此方法加载。
✅ 正确理解 getSystemResource() 的查找范围
ClassLoader.getSystemResource(String name) 等价于：ClassLoader.getSystemClassLoader().getResource(name)。
它只搜索以下位置（按顺序）：
- Maven/Gradle 构建后输出的
target/classes/（或build/classes/）及其子目录 -
src/main/resources/下的文件（开发期由 IDE 或构建工具自动复制进去） - JAR 包中的
BOOT-INF/classes/（Spring Boot 打包后） - 显式添加到 classpath 的目录或 JAR（如
-cp ./config/启动时指定）
⚠️ 它不搜索：项目根目录（./）、src/ 根、target/ 根、或任意绝对路径，除非你手动把那个目录加进 classpath。
✅ 如何让配置文件可被 getSystemResource() 加载
核心原则：**确保文件位于 classpath 中**。常见做法：
-
放在
src/main/resources/下（推荐）
例如：src/main/resources/config.properties→ 调用ClassLoader.getSystemResource("config.properties") -
将外部目录加入 classpath 启动
启动命令加参数：java -cp "./config/:." MyApp，此时getSystemResource("app.conf")可加载./config/app.conf -
使用 Maven 资源插件复制非标准目录
在pom.xml中配置<resources>，把src/main/config也纳入 classpath 输出
✅ 代码示例（安全写法）
不要假设资源一定存在，务必判空：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
URL configUrl = ClassLoader.getSystemResource("config.properties");
if (configUrl == null) {
throw new RuntimeException("config.properties not found in classpath");
}
try (InputStream is = configUrl.openStream()) {
Properties props = new Properties();
props.load(is);
// 使用 props...
}
注意：
• 返回的是 URL，不是文件路径，不能直接转 File（尤其在 Jar 包中会是 jar:file:///... 协议）；
• 若需读取为字符串，建议用 configUrl.openStream()，而非 new File(configUrl.toURI())（后者在 Jar 中会抛 IllegalArgumentException）。
❌ 常见误区与替代方案
如果你坚持要读“项目根目录下的文件”（比如 ./application.yml），getSystemResource() 不适用，应改用：
-
new File("application.yml")（相对路径基于 JVM 启动目录，非项目根） -
Paths.get(System.getProperty("user.dir"), "application.yml")（获取当前工作目录） - Spring Boot：用
@Value("${...}")或ConfigurableEnvironment，自动支持classpath:、file:、optional:file:等前缀
不复杂但容易忽略：资源加载的本质是 classpath 查找，不是文件系统遍历。把文件放对位置，比写复杂逻辑更可靠。
