JarURLConnection读取JAR资源时，最大陷阱是路径以/开头导致ClassLoader误判为绝对路径而失败；应统一用相对路径（如"META-INF/MANIFEST.MF"），优先使用getResourceAsStream()，仅需元数据时才安全转型并connect()后操作。
用 JarURLConnection 读取 JAR 包内资源时，最典型的“变量资源”问题，其实不是变量本身的问题，而是路径写法触发了类加载器和 URL 协议解析的隐式规则——稍不注意，getResource() 返回 null，或 openConnection() 后强转失败、流为空，最终导致程序在 IDE 里正常、打包后崩溃。
路径开头的斜杠 / 是最大陷阱
很多人习惯写成：
-
getClass().getResource("/config.json")✅（这是合法的绝对路径） -
getClass().getResource("/com/example/config.json")✅（完整类路径，推荐） -
getClass().getResource("/META-INF/MANIFEST.MF")❌（看似合理，但多数情况下失败）
问题出在：当路径以 / 开头，ClassLoader 会从 classpath 根开始查找；而 META-INF 不在 classpath 根下，它属于 JAR 包元数据目录，不在资源加载路径范围内。更关键的是，JarURLConnection 解析时若遇到带 / 的路径（尤其是 /META-INF/...），会尝试映射到不存在的“文件系统根”，直接抛 FileNotFoundException。
正确做法是去掉前导斜杠，用相对路径访问 JAR 内部结构：
-
getClass().getResource("META-INF/MANIFEST.MF")✅（相对于当前类所在包——但通常不生效） -
Thread.currentThread().getContextClassLoader().getResource("META-INF/MANIFEST.MF")✅（推荐，绕过类加载委托限制）
不要手动强转 JarURLConnection
常见错误代码：
URL url = new URL("jar:file:/app.jar!/config.json");
JarURLConnection conn = (JarURLConnection) url.openConnection(); // ⚠️ 这里可能 ClassCastException
conn.connect();
JarFile jarFile = conn.getJarFile();
问题在于：url.openConnection() 在开发环境（如 IDEA）常返回 FileURLConnection，协议是 file: 而非 jar:，强转必崩。即使协议正确，也必须先 connect() 才能调用 getJarFile()，否则抛 IllegalStateException。
稳妥做法是先判断协议再转型：
if ("jar".equals(url.getProtocol())) {JarURLConnection juc = (JarURLConnection) url.openConnection();juc.connect();return juc.getJarFile();}
资源名含空格、中文或特殊字符会静默失败
比如资源名为 config v2.json 或 用户配置.xml，getResource() 返回的 URL 会自动编码为 config%20v2.json。但某些 JDK 版本（尤其是 8u2x 及更早）的 JarURLConnection 在解析已编码路径时会出错，表现为：
- 返回空流（
InputStream为null或读取长度为 0） - 抛
IOException: invalid manifest format（误判为 MANIFEST 损坏）
根本解法是避免编码风险：
- 资源文件命名只用 ASCII 字母、数字、下划线
_、短横线- - 路径中不出现空格、括号、中文、
%、+、#等字符 - 如必须支持，改用
URLDecoder.decode(url.getPath(), "UTF-8")手动解码后再构造逻辑路径（但极少需要）
优先用 getResourceAsStream()，别碰 JarURLConnection
95% 的场景根本不需要 JarURLConnection。你要读内容？直接用：
getClass().getResourceAsStream("config.json")Thread.currentThread().getContextClassLoader().getResourceAsStream("db/sqls/init.sql")
它自动适配开发环境（file:）与生产环境（jar:），内部已封装协议差异，不会空指针，也不用关心连接、关闭、转型。只有当你需要获取 JarFile 实例（比如遍历所有 jarEntry、检查签名、提取多个资源列表）时，才值得走 JarURLConnection 流程。
