从代码或已有jar/classes创建补丁时class反编译异常咨询

差异原因说明 #

执行jar命令打包的过程不会对class文件做二次编译，你看到的反编译结果差异和二次编译无关，大概率是两个操作错误导致的：

• 复制class文件时没有保留完整的包目录结构，或者漏拷了关联的内部类、匿名类、Lambda生成的类（即文件名带$的关联class文件）
• 你使用的打包命令有误：jar cvf patch.jar -C path/to/files 缺少必填的目标内容参数，正确写法应该在路径后加.，代表打包该路径下的全部内容，命令写法错误会导致生成的jar包内部结构错乱，反编译自然会显示异常。

class被二次编译的影响 #

如果操作过程中确实误触发了class二次编译（比如误复制了.java源文件、打包流程中嵌入了编译步骤），会造成以下问题：

• 若二次编译使用的JDK版本和原项目构建版本不一致，补丁部署后会直接抛出UnsupportedClassVersionError，导致类无法加载
• 若二次编译时依赖的类版本和原项目运行时依赖不匹配，会出现方法签名不存在、字段缺失等错误，触发运行时异常
• 不同编译器（如Oracle javac、Eclipse ecj）或不同编译参数生成的字节码存在差异，哪怕逻辑一致，也可能出现和原字节码不兼容的问题，导致线上故障。

标准补丁包（仅含指定class）创建流程 #

• 从Maven构建输出的target/classes目录，或者原始已构建好的jar包中提取需要替换的class文件，必须严格保留原有的包层级目录结构，例如全限定类名为com.example.OrderService的类，必须存放于com/example/路径下，和原jar包内路径完全一致；所有和该类关联的内部类、匿名类、Lambda生成类（类名带$的同前缀class文件）必须全部复制，不能遗漏
• 核对复制的文件列表，确认没有混入.java源文件、测试类、无关依赖的class文件，同时核对每个class文件的大小、修改时间，和原构建输出的文件完全一致，避免拷贝错版本
• 进入存放补丁文件的根目录（即path/to/files，该目录下第一层为com、org等顶级包目录），执行正确的打包命令：jar cvfM patch.jar .，其中参数M代表不自动生成MANIFEST.MF文件，避免覆盖原应用的配置；如果需要自定义补丁包的MANIFEST配置，可提前从原jar中提取对应META-INF/MANIFEST.MF文件放到补丁目录对应路径下再打包
• 打包完成后执行jar tf patch.jar查看包内文件路径，和原jar中对应类的路径逐一比对，确认路径完全一致，再通过反编译工具核对类内容，确认和原jar中对应类的反编译结果无差异后再使用。

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