如何在 Ja va 中通过 Class.getResource() 读取 Classpath 下的资源文件并获取其绝对路径
开门见山地说，Class.getResource() 这个方法，它本身并不返回你想象中的那个文件系统绝对路径。它返回的是一个 URL 对象，这个对象指向的是 classpath 下的某个资源。这个资源可能藏在 JAR 包里，也可能躺在文件系统的某个目录里，或者在 Ja va 9 之后的模块路径中。所以，直接去获取“绝对路径”这件事，在大多数场景下，不仅不可靠，而且通常也不是最佳实践。不过别急，根据你的实际需求，总有合适的处理方式。
理解 getResource() 返回的 URL 类型
当你调用类似 clazz.getResource("/config.properties") 或 clazz.getResource("data.json") 这样的代码时，得到的 URL 可能会以几种不同的面貌出现：
file:/path/to/project/target/classes/config.properties—— 这是在开发环境，资源直接从文件系统加载。jar:file:/path/to/app.jar!/BOOT-INF/classes!/config.properties—— 这是 Spring Boot 应用打包后，资源被封装在 JAR 包内的典型情况。jrt:/ja va.base/ja va/lang/Object.class—— 这是 Ja va 9 引入模块系统后，访问模块内资源的新协议。
这里有个关键点：只有协议头是 file: 的 URL，才有可能安全地转换为本地绝对路径。对于那些在 JAR 包内或者模块中的资源，传统的“绝对路径”概念根本就不存在。
仅当资源在文件系统中时：转为 File 绝对路径
如果你能百分之百确定资源就位于磁盘目录里（比如在 IDE 中直接运行、或者 Ma ven 项目还没打包），那么可以尝试进行转换。具体怎么做呢？看下面的代码示例：
立即学习“Ja va免费学习笔记（深入）”；
URL url = MyClass.class.getResource("/config.properties");
if (url != null && "file".equals(url.getProtocol())) {
try {
File file = new File(url.toURI()); // 推荐使用 toURI()，它能更好地处理空格和特殊字符
String absolutePath = file.getAbsolutePath();
System.out.println("绝对路径：" + absolutePath);
} catch (URISyntaxException e) {
throw new RuntimeException(e);
}
}
需要特别提醒的是，直接使用 url.getFile() 并不可靠，因为它返回的字符串可能包含像 %20 这样的 URL 编码字符，而且它不会帮你校验协议类型。相比之下，toURI() 方法是更健壮的选择。
需要读取内容？优先用 InputStream，而非路径
其实，绝大多数情况下，我们调用 getResource 的最终目的，是为了读取资源的内容，比如加载配置、解析 JSON 或者读取模板文件。对于这些场景，最正确、最通用的做法是直接使用输入流，而不是费劲去获取路径。
- ✅ 正确做法：使用
getResourceAsStream获取InputStream。这种方式通吃所有环境——无论是在 JAR 包内、模块中，还是不同的部署方式下，它都能正常工作。 - ❌ 错误做法：先强行提取出路径字符串，然后再用
new FileInputStream()去打开。一旦资源被打进 JAR 包，这种方法必然会失败。
来看看推荐的代码写法：
try (InputStream is = MyClass.class.getResourceAsStream("/config.properties")) {
if (is == null) {
throw new IllegalArgumentException("资源未找到");
}
Properties props = new Properties();
props.load(is);
}
需写入或访问父目录？考虑资源定位策略
如果你的业务逻辑必须依赖“资源所在的目录”，比如需要向同目录写入文件，或者访问其上级目录，那么这可能意味着你的设计思路稍微偏离了 classpath 资源的使用原则。classpath 资源的设计初衷是“只读”的。
不过，问题总有解决办法。这里有几个可行的替代方案供你参考：
- 将配置目录设置为独立的系统属性，例如通过启动参数
-Dconfig.dir=/etc/myapp指定。这样就能完全绕过 classpath 机制。 - 使用
ClassLoader.getResources()方法，它可以获取 classpath 中所有匹配指定名称的资源。这在多模块或复杂类加载器场景下很有用。 - 如果项目使用了 Spring 这类框架，那么恭喜你，框架提供的
ResourceLoader抽象已经完美解决了这个问题。它能统一处理classpath:、file:、甚至https:等多种协议的资源定位。
最后再强调一次：在代码里硬编码绝对路径，会严重破坏应用的可移植性，通常不被建议作为通用解决方案。理解不同场景，选择最合适的工具，这才是关键所在。
