Java基础教程（九十八）IO之读取classpath资源：深度解析，Java中classpath资源读取的奥秘与实战技巧

一、核心机制解析

ClassLoader.getResource()
以绝对路径查找（无前导/），路径相对于classpath根目录。

javaURL url = this.getClass().getClassLoader().getResource("config/app.properties");

Class.getResource()
路径以/开头时从classpath根目录查找；否则相对于当前类所在包。

URL url = MyClass.class.getResource("/global-config.xml"); // 根目录
URL url2 = MyClass.class.getResource("local-config.txt"); // 同包目录

二、不同场景下的实战方案

▶ 基础场景：直接读取文件

try (InputStream is = Thread.currentThread().getContextClassLoader()
                          .getResourceAsStream("data/users.json")) {
    String content = new String(is.readAllBytes(), StandardCharsets.UTF_8);
    System.out.println(content);
}

▶ Spring框架高效读取

import org.springframework.util.ResourceUtils;
import org.springframework.core.io.Resource;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;

// 精确匹配单个文件
File file = ResourceUtils.getFile("classpath:init.sql");

// 模式匹配多个资源
Resource[] resources = new PathMatchingResourcePatternResolver()
                .getResources("classpath*:mappers/*.xml");

三、关键注意事项

路径格式

- 使用/分隔符（Windows/Linux通用）
- 避免路径开头误加/（ClassLoader不支持）

资源热加载问题
默认资源在类加载时缓存，修改后需重启应用。动态加载需自定义ClassLoader。
JAR包内资源
只能通过getResourceAsStream()读取，无法直接获取File对象。

最佳实践总结
✅ 优先选ClassLoader.getResource()：路径行为更统一
✅ 复杂场景用Spring工具类：简化通配符匹配
✅ 路径不加前导斜杠：兼容ClassLoader与Class两种方式
✅ 大文件用Stream处理：避免readAllBytes()内存溢出

掌握这些技巧，可彻底解决Java项目中资源加载的各类疑难问题，提升开发效率与系统稳定性。