JarException通常源于JAR包结构损坏或签名失效，而非代码错误；它表明JAR无法被安全加载，且不提供具体定位信息。
Java读取损坏Jar时抛出JarException的典型现象
遇到JarException，基本不是代码写错了，而是底层java.util.jar.JarFile或ZipInputStream在解析字节流时发现结构异常——比如中央目录损坏、签名块校验失败、或文件头被截断。常见报错信息形如：java.util.zip.ZipException: zip file is empty或java.util.jar.JarException: invalid CEN header，但JDK有时会把底层ZipException包装成JarException向上抛出。
关键点：这个异常本身不带定位线索（比如哪一行、哪个entry），它只说明“整个jar包已无法被标准API安全加载”，不能靠try-catch后继续读后续entry来绕过。
用ZipFile代替JarFile做轻量级结构探测
JarFile是ZipFile的子类，但做了更严格的校验（比如MANIFEST.MF格式、签名验证）。如果只是想确认jar是否可读、有哪些entry、甚至提取某个class，直接用ZipFile能绕过部分校验，拿到更多上下文。
实操建议：
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 先用
new ZipFile(jarPath)尝试打开，成功则说明zip结构基本完好；失败则大概率是物理损坏或权限问题 - 若打开成功，用
getEntry("META-INF/MANIFEST.MF")检查关键文件是否存在，再用getInputStream()读取内容——避免调用JarFile.getManifest()，它会触发完整签名验证 - 不要在生产逻辑中长期用
ZipFile替代JarFile，因为跳过签名校验可能带来安全风险
解压损坏Jar前必须做的三件事
别急着用jar -xf或IDE双击打开。损坏jar往往伴随隐性问题：部分entry可读、部分不可读、中央目录偏移错误、或末尾填充了非法字节。盲目解压可能让工具静默跳过坏entry，你以为解出来了，实际缺了关键class。
正确做法：
- 用
unzip -t <code>jarPath做完整性测试，它会逐个校验CRC32并报告损坏entry名（如果有） - 用
binwalk <code>jarPath（需安装）查看文件头和末尾是否有异常数据块，比如嵌入了非zip内容 - 用
xxd <code>jarPath| head -20确认开头确实是PK\x03\x04，结尾是否以PK\x05\x06（EOCD）结束——缺失EOCD是常见原因，此时ZipFile可能仍能读，但JarFile必然失败
修复jar签名失效导致的JarException
很多“损坏”其实是签名失效：比如修改过class后没重签名，或从网络下载时MANIFEST.MF与SF文件哈希不匹配。此时JarFile在构造时就会抛JarException，但jar包本身zip结构完全正常。
验证方式：
- 删掉
META-INF/*.SF、META-INF/*.DSA、META-INF/*.RSA这几个签名相关文件，再用JarFile打开——如果成功，就确认是签名问题 - 若需保留签名，用
jarsigner -verify <code>jarPath看具体哪一项失败（如“signature was not verified”或“digest mismatch”） - 重签名前确保MANIFEST.MF中每个entry的
Name:字段路径与实际jar内路径严格一致（注意大小写、斜杠方向），否则重签也无效
签名修复不是万能的——如果原始jar被篡改过class字节码，重签名只能掩盖问题，运行时仍可能VerifyError。
