如何使用Java的Class.getResourceAsStream()方法访问嵌套在Jar包中的默认资源文件？

本文共计703个文字，预计阅读时间需要3分钟。

相关专题

在 java 中，class.getresourceasstream() 是读取 jar 包内资源文件最常用、最可靠的方式。关键在于路径写法要符合类加载器的查找规则——它基于类的包结构和类路径（classpath）进行解析，且对 jar 包完全透明。

路径必须以斜杠开头（绝对路径）或不加斜杠（相对路径）

如果资源文件与当前类在同一包下，可直接用不带斜杠的名称；若在根目录（即 META-INF/ 同级），必须以 / 开头。例如：

• MyClass.class.getResourceAsStream("config.properties") → 查找同包下的 config.properties
• MyClass.class.getResourceAsStream("/images/logo.png") → 查找 Jar 根目录下的 images/logo.png
• MyClass.class.getResourceAsStream("data/data.json") → 查找同包下子目录 data/data.json（注意不是 ./data/...）

路径中的分隔符必须是正斜杠（/），不能用反斜杠（）

即使在 Windows 系统中，Jar 内部资源路径也统一使用 /。用 会导致返回 null，且无异常提示。例如：

• ✅ 正确："/META-INF/MANIFEST.MF"、"templates/email.ftl"
• ❌ 错误："\templates\email.ftl"、"/templates\email.ftl"

确保资源文件已正确打包进 Jar

编译时资源不会自动复制到输出目录。需确认构建工具（Maven/Gradle）已将目标文件纳入 src/main/resources（Maven）或对应资源目录。打包后可用 jar -tf your-app.jar | grep "filename" 验证是否存在。常见遗漏情况包括：

• 文件放在 src/main/java 下但未标记为资源目录
• IDE（如 IntelliJ）未启用 “Always compile on build” 或资源拷贝被排除
• 路径名大小写错误（Linux/Jar 文件系统区分大小写）

避免使用 File 构造器，始终用 InputStream 处理

不要尝试把 getResourceAsStream() 返回的流转成 File 对象（比如调用 toURI().getPath()），这在 Jar 中会失败（URL 协议是 jar: 而非 file:）。应直接读取流：

立即学习“Java免费学习笔记（深入）”；

try (InputStream is = MyClass.class.getResourceAsStream("/conf/app.conf")) { if (is == null) { throw new RuntimeException("Resource not found: /conf/app.conf"); } Properties props = new Properties(); props.load(is); }

只要路径正确、资源存在、打包无误，getResourceAsStream() 就能在开发环境和 Jar 包中一致工作。