如何在 Java 中通过 Class.getResource() 读取 Classpath 下的资源文件并获取其绝对路径

如何在 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:、甚至 http: 等多种协议的资源定位。

最后再强调一次：在代码里硬编码绝对路径，会严重破坏应用的可移植性，通常不被建议作为通用解决方案。理解不同场景，选择最合适的工具，这才是关键所在。