如何在 Java 中通过 Class.getResource() 获取并读取 Classpath 根目录下的资源-java教程-PHP中文网

clazz.getResource("") 和 clazz.getResource("/") 返回 null 是规范行为：前者按相对路径解析为包路径加 /，后者试图获取无实体的 classpath 根目录，而 classpath 根是逻辑概念，无对应资源实体。

如何在 java 中通过 class.getresource() 获取并读取 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"）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

始终先判空：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。