跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

如何在 Java 中通过 Class.getResource() 获取并读取 Classpath 根目录下的资源

clazz.getResource("") 和 clazz.getResource("/") 返回 null 是规范行为:前者按相对路径解析为包路径加 /,后者试图获取无实体的 classpath 根目录,而 classpath 根是逻辑概念,无对应资源实体。 Class.getResource() 为什么传空字符串或 "/" 会返回 null 直接调用
clazz.getResource("")
或
clazz.getResource("/")
在多数情况下返回
null
,不是 bug,而是规范行为。JVM 规定:当路径以
/
开头时,
getResource()
会从 classpath 根开始查找;但传入纯
"/"
表示“根目录本身”,而 classpath 根是逻辑路径,没有对应的真实目录资源(尤其在 jar 包中),所以返回
null
。传空字符串则按相对路径解析,等价于
clazz.getPackage().getName().replace('.', '/') + "/"
,显然也不是根。 正确获取 classpath 根路径的两种可靠方式 想读取 classpath 根下的文件(如
config.json
、
logback.xml
),必须绕过“获取根目录”这个无效目标,转而直接定位具体资源: 用
clazz.getResource("/config.json")
—— 路径以
/
开头,表示从 classpath 根查找,只要该文件在
src/main/resources/
或类路径任意位置存在即可 用
ClassLoader.getSystemResource("config.json")
或
clazz.getClassLoader().getResource("config.json")
—— 不加
/
,同样从 classpath 根开始搜索(ClassLoader 的
getResource()
本就以根为基准) 二者行为一致,但推荐后者:显式使用当前类的 ClassLoader,避免系统类加载器找不到模块内资源(尤其在 modular JDK 或 OSGi 环境下)。 读取资源流时必须检查 null,且不能依赖 URL 协议类型
getResource()
返回
URL
,但该 URL 可能是
file:
、
jar:
、
jrt:
(Java 9+ 模块)甚至自定义协议。直接调用
url.toURI()
或
new File(url.toURI())
在 jar 包中会抛
IllegalArgumentException
("JAR entry is not a file")。 Eclipse导入Android或其他的JAVA项目的正确方法 WORD版 本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法;希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看 下载 立即学习 “ Java免费学习笔记(深入) ”; 始终先判空:
URL url = clazz.getResource("/app.properties"); if (url == null) throw new IllegalStateException("Resource 'app.properties' not found on classpath");
用
url.openStream()
直接读取,它对所有协议都兼容 需要文件内容为字符串?用
new String(url.openStream().readAllBytes(), StandardCharsets.UTF_8)
(Java 11+),或搭配
InputStreamReader
手动指定编码 IDE 运行 vs. 打包后行为差异及常见陷阱 IntelliJ/Eclipse 默认把
src/main/resources
加入 classpath,IDE 运行时
getResource("/foo.txt")
能读到;但 Maven 打成 jar 后,资源变成 jar 内部条目,此时仍可用
openStream()
,但以下操作会失败:
url.getFile()
→ 返回
jar:file:/path/to/app.jar!/foo.txt
,这不是合法文件路径
new File(url.toURI())
→
java.nio.file.FileSystemNotFoundException
(jar 内容不在默认 FileSystem 中) 试图用
File.list()
列出 classpath 根下所有文件 → 不可能,classpath 是扁平化资源集合,无“目录结构”概念 如果真需遍历 classpath 根下某类资源(如所有
*.yaml
),必须用
ClassLoader.getResources()
获取匹配 URL 集合,再逐个打开流解析,不能依赖文件系统 API。

相关文章