使用install4j与ProGuard打包Spring Boot应用遇java.lang.VerifyError求助

这个错误的核心原因非常明确：你使用了ProGuard的-dontpreverify选项，而Java 7及以上版本的JVM会严格检查字节码的栈映射帧（StackMapTable），这个选项会直接阻止ProGuard生成必要的栈映射信息，导致JVM在验证字节码时失败。下面是具体的排查和修复方向：

1. 立即移除-dontpreverify选项 #

这是最关键的一步，-dontpreverify是为兼容Java 5及以下老旧版本设计的，在现代JVM环境下完全没必要保留。移除它之后，ProGuard会自动为混淆后的字节码生成合法的栈映射帧，这通常能直接解决VerifyError问题。

2. 调整激进的优化配置 #

你的ProGuard配置中使用了-optimizationpasses 3和-overloadaggressively，这些激进的优化可能会破坏字节码结构，尤其是和Spring Boot这类依赖大量反射、注解的框架结合时。建议：

• 先暂时将-optimizationpasses改为1，或者直接添加-dontoptimize关闭优化，测试混淆后的jar是否能正常运行。
• 如果关闭优化后问题解决，再逐步开启优化，同时添加更精细的Keep规则保护Spring Boot核心组件和你的业务类。

3. 完善ProGuard的Keep规则 #

Spring Boot应用依赖大量注解和反射机制，仅仅保留Main类的main方法远远不够。你需要添加更多规则保护关键类：

# 保护Spring Boot核心注解类
-keep @org.springframework.boot.autoconfigure.SpringBootApplication class *
-keep @org.springframework.stereotype.Component class *
-keep @org.springframework.stereotype.Service class *
-keep @org.springframework.stereotype.Repository class *

# 保护依赖注入相关的成员变量和方法
-keepclassmembers class * {
    @org.springframework.beans.factory.annotation.Autowired *;
    @org.springframework.beans.factory.annotation.Value *;
    @org.springframework.web.bind.annotation.GetMapping *;
    @org.springframework.web.bind.annotation.PostMapping *;
    # 根据你的业务场景添加更多注解规则
}

# 保护Jackson和DSL-Json的序列化/反序列化类
-keep class com.fasterxml.jackson.** { *; }
-keep class com.dslplatform.json.** { *; }
-keep class com.fasterxml.jackson.databind.ObjectMapper {
    public <T> T readValue(java.io.InputStream, java.lang.Class<T>);
    public void writeValue(java.io.OutputStream, java.lang.Object);
}

4. 排查混淆后的字节码完整性 #

使用ProGuard的诊断选项确认混淆过程没有破坏关键类：

• 添加-printseeds seeds.txt：生成保留类/方法的列表，检查你的业务类和Spring核心类是否被正确保留。
• 添加-printmapping mapping.txt：生成混淆前后的类名/方法名映射，方便后续调试。
• 直接用java -jar运行混淆后的jar，先跳过install4j打包，确认混淆本身没有问题。如果单独运行正常，再排查install4j的配置。

5. 检查install4j的打包配置 #

如果混淆后的jar单独运行正常，但install4j打包后出错，需要检查：

• install4j是否修改了字节码或类路径：确保install4j只是将jar打包进安装包，没有对字节码进行额外处理。
• install4j指定的JVM版本：确保打包时选择的JVM版本和你混淆、测试时的版本一致，避免跨版本兼容性问题。
• 检查install4j的启动配置：是否正确指定了Main类，类路径是否包含所有依赖库。

6. 替代临时的-dontwarn选项 #

-dontwarn会隐藏ProGuard的警告信息，可能掩盖潜在问题。建议移除它，然后逐个处理出现的警告：

• 如果是某个库的类找不到，确认-libraryjar路径是否正确，或者添加对应的-keep规则忽略这些类。
• 如果是内部类或方法的警告，确保你已经添加了-keepattributes InnerClasses（你当前配置已包含）或对应的-keepclassmembers规则。

最后建议你逐步调整配置，每次只修改一个选项并测试，这样更容易定位问题根源。

内容的提问来源于stack exchange，提问作者Adrian Grzywaczewski