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"）。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“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。
