如何在 Java 中通过 ClassLoader.getResource() 获取项目路径下的资源文件的绝对路径

星墨小哥_1026

星墨小哥_1026

2026-05-06

502人浏览

原创

classloader.getresource()返回url而非文件路径,不可直接用于file构造;应优先用getresourceasstream()流式读取,仅在必要时通过touri()安全提取file协议下的绝对路径或解压至临时文件。

如何在 java 中通过 classloader.getresource() 获取项目路径下的资源文件的绝对路径

ClassLoader.getResource() 返回的是 URL,不是文件路径

直接调用 ClassLoader.getResource("config.json") 得到的是一个 URL 对象,比如 jar:file:/app.jar!/config.json 或 file:/home/user/project/src/main/resources/config.json。它**不保证是可访问的本地文件路径**,更不能直接传给 new File(url.toString()) —— 这在 Jar 包里会生成非法路径,导致 FileNotFoundException。

常见错误现象:

  • 开发时 IDE 下能读,打包成 Jar 后报 NullPointerException(getResource() 返回 null)
  • 用 url.toURI().getPath() 解析出带 !/ 的字符串,再构造 File 失败
  • 路径含空格或中文时,URL#getPath() 未解码,导致乱码或找不到文件

想获取“绝对路径”?先确认你是否真的需要

绝大多数场景下,你**不需要也不应该依赖资源的绝对磁盘路径**。资源可能根本不在文件系统中(如在 Jar、War、模块化 JAR、甚至远程类加载器里)。正确做法是用 getResourceAsStream() 流式读取。

只有极少数情况才需真实文件路径,例如:

  • 要将资源复制到临时目录并由外部命令(如 Python 脚本、ffmpeg)读取
  • 调试时想快速定位资源在磁盘上的位置
  • 使用某些只接受 String path 的旧 API(如 Log4j 1.x 的 PropertyConfigurator.configure(path))

此时必须做运行时判断:资源是否在普通文件系统中?

安全提取 file:// 协议下的绝对路径

如果确定资源在 classpath 的文件目录中(非 Jar),可用以下方式提取真实路径:

Java注释规范Skills
Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载
URL resource = MyClass.class.getClassLoader().getResource("logback.xml");
if (resource != null && "file".equals(resource.getProtocol())) {
    try {
        File file = new File(resource.toURI()); // toURI() 自动解码空格/中文
        String absolutePath = file.getAbsolutePath();
        System.out.println(absolutePath);
    } catch (URISyntaxException e) {
        // 不应发生,但需捕获
    }
}

关键点:

  • 必须检查 resource != null,否则 NPE
  • 必须检查 "file".equals(resource.getProtocol()),跳过 jar:、jrt: 等协议
  • 用 toURI() 而非 getPath(),避免 URL 编码问题(如空格变成 %20)
  • 不要用 new File(resource.toString()) —— toString() 返回完整 URL 字符串,含协议头

Jar 包内资源无法获得“绝对路径”,只能解压到临时目录

当 getResource() 返回类似 jar:file:/app.jar!/application.properties 的 URL 时,file:/app.jar 是 Jar 文件路径,但 application.properties 并非独立文件 —— 它是 Zip 条目。此时没有“绝对路径”概念。

若强行需要文件路径(比如传给不支持流式输入的库),唯一可靠方式是:

  • 用 getResourceAsStream() 读取内容
  • 写入 Files.createTempFile() 创建临时文件
  • 用完后记得 deleteOnExit() 或手动清理(尤其服务长期运行时)

示例:

InputStream is = MyClass.class.getClassLoader().getResourceAsStream("schema.sql");
Path tempFile = Files.createTempFile("schema-", ".sql");
Files.copy(is, tempFile, StandardCopyOption.REPLACE_EXISTING);
String tempPath = tempFile.toAbsolutePath().toString(); // ✅ 这才是真正的绝对路径
// ... 使用 tempPath ...
tempFile.toFile().deleteOnExit();

真正容易被忽略的是:资源位置与部署形态强耦合。同一段代码,在 IDE、Spring Boot fat jar、JLink 构建的镜像、模块路径(--module-path)下,getResource() 行为都不同。别假设“它一定在某个目录下”。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java ssl

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11217

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8322

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7192

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1204

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

968

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1436

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2949

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20211

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1295

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习