- restore generic signatures, scoped variables and missing code from original bytecode - remove decompiler artifacts and document classes, methods, fields and packages - restore resources, add Batik/BouncyCastle dependencies and build/runtime docs
14 KiB
MiDM 反编译正确性审计报告
审计对象:D:\Develop\MiDM(由 D:\Develop\mdm_or 反编译)
基准:D:\Develop\mdm_or\WEB-INF\classes 的 246 个 class + WEB-INF/lib/CELL-1.0.0.1.jar 的 89 个 class
日期:2026-11-16
结论
原项目不能编译:直接执行 javac 有 109 个编译错误,分布在 36 个文件。根因不是业务代码写错,而是反编译时丢失了泛型签名、变量作用域和部分语句。
本次审计以原始字节码为唯一基准,完成了:
- 从字节码恢复 114 个 Java 文件的泛型/方法签名(约 540 处);
- 修复 17 处变量重名、变量丢失、通配符捕获等反编译缺陷;
- 发现并修复 3 处会改变运行时行为的偏差(
DbConfig丢失代码块、CloudStorageService多出 null 判断、BaseFile多出 null 判断); - 修复 4 处缺失的
break,补齐 3 个丢失的资源文件,替换 2 个不一致的二进制资源; - 补齐
pom.xml中缺失的 Batik、BouncyCastle 依赖。
修复后:
- 271 个 Java 源文件编译通过,0 error;
- 246 个原始类、3,599 个方法中,3,583 个方法的语义操作序列与原始字节码完全一致,其余 16 个仅为 javac 11 → javac 18 的代码生成差异(枚举
<clinit>、字符串拼接、装箱、iinc); - 89 个 CELL 类、883 个方法中 878 个完全一致,其余 5 个同样是编译器版本差异;
- 类注解、方法/字段注解:0 差异(246 + 89 个类全部逐项比较);
- 异常表(catch 类型):0 差异;
- 字段、方法、常量值、继承关系:0 差异;
- switch 的 case 集合:0 差异(com.midm);
- 资源文件:修复后 2,722 / 2,722 个文件哈希完全一致。
一、阻断编译:泛型签名被整体剥离(109 errors / 35 files)
反编译产物把所有 Signature 属性丢掉了,类、方法、字段、局部变量都退化成裸类型,典型报错:
BaseService.java:110: cannot find symbol: class T(方法级<T>丢失)DeviceService.java:229: Object cannot be converted to Device(List<T>变成裸List)FileService.java:169: Object cannot be converted to UUIDDateConverter.java: 不是抽象类,未覆盖 convert(implements Converter<String, Date>变成裸Converter)ProfileApps.java: List<CAP#1> cannot be converted to List<InstallApp>(通配符捕获)DbObject.java: Map<CAP#1,CAP#2> cannot be converted to Map<String,Object>
修复方式:对每个类用 javap -p -s 读出原始 Signature,按“方法名 + 参数个数 + 参数类型”对齐,恢复:
- 类/方法类型参数,如
public <T> T findById(Class<T>, Object); - 返回值与参数泛型,如
List<Device>、PageImpl<T>、Converter<String, Date>; - 字段泛型,如
List<SiteInfo> sites; - 必要处补回
Class<T>、Collection<?>等。
共修改 114 个 Java 文件、约 560 处签名,并补回 4 个文件缺失的 import。
二、变量作用域 / 重名 / 丢失(17 errors)
Fernflower 在 switch、try/catch、lambda 等场景把不同作用域的变量重名,或直接漏掉声明。已逐处对照 LocalVariableTable 和字节码修复:
| 文件 | 问题 | 修复 |
|---|---|---|
SettingsService.java:257 |
settingsMap.put(key, (Object)null) 与 Map<String,String> 不兼容 |
null |
SettingsService.java:316/322 |
两个 case 各自声明 Long expiry,Java 同一 switch 作用域冲突;字节码中两段作用域互不重叠 |
两个 case 分别加 {} 块 |
FileService.java:950 |
clearSite 中 category 变量被漏掉,只剩 category 的引用 |
恢复 String category = file.getName(); 并 switch(category) |
ReportService.java:264 |
方法级 groupOption 声明被漏掉,:584 仍在使用 |
恢复 String groupOption = settings.getString("groupOption","all"); |
DbInitialize.java:190 |
游标变量与后面的 Document indexDefinition 重名;原字节码实际是两段 foreach |
改为两个 for (Document index : collection.listIndexes()) |
ExternalApiService.java:76 |
Pair 局部变量与 String[] decryptStrings 重名 |
将 Pair 改名为 failureResult |
DeviceApi.java:1184 |
循环内 DeviceLicense license 与外层同名 |
改为 deviceLicense |
OtaFile.java:646 |
String curDisplayId 被重复声明 |
复用外层变量 |
NewsMessageService.java:534 |
Set ssnSet 重复声明 |
复用外层变量 |
BaseFile.java:119 |
lambda 参数 key/value 类型丢失;且多出原始字节码没有的 value != null 判断 |
显式 String key / String[] value,并删除多余的 null 判断 |
DbObject.java |
List<T> 中 T 未定义、Map 构造器通配符不兼容 |
裸 List + super((Map)map) |
GeneralProfile.java |
<T> T getProfile(...) 返回 Object/(Object)null |
补 (T) 转换 |
NewsMessage.java:94 |
原始 LinkedTreeMap 的 entrySet() 迭代元素为 Object |
先取 Object,再显式转 Map.Entry |
StoreApp.java:67 |
Set<Integer>.addAll(List<?>) 捕获失败 |
显式 (Collection) 转换 |
UserApi.java:1516 |
List<?> 传给 saveUsers(List<User>) |
显式 (List<User>) 转换 |
McJsonUtils.java:221 |
<T> T clone(Object) 泛型推断失败 |
补 (T) 转换 |
三、会改变运行时行为的偏差(3 处)
3.1 DbConfig.getConnectiontString():原始字节码中的两段代码被整体丢掉
原始字节码在 waitqueuetimeoutms 之后还有:
- 第二个
connectTimeoutMS判断块(与前面的块重复):
if (!params.contains("connectTimeoutMS")) {
uriBuilder.setParameter("connectTimeoutMS", String.valueOf(this.connectTimeout));
}
- 一个
socketTimeoutMS块:
if (this.socketTimeout > 0 && !params.contains("socketTimeoutMS")) {
uriBuilder.setParameter("", "");
}
反编译源码里这两段完全不存在,意味着连接串的 connectTimeoutMS 只设置一次、socketTimeoutMS 完全不处理。现已按字节码恢复(DbConfig.java:191、:199)。
注意:第二段用空字符串作为参数名和值,是原始程序本身的行为,不是反编译写错;为保持与线上 WAR 完全一致,照原样恢复。
3.2 CloudStorageService.updateMetaInfo():反编译多出一个 null 判断
原始字节码是直接调用:
this.cloudStorage.updateMetaInfo(fileName, contentType, paths);
反编译源码却生成:
if (this.cloudStorage != null) {
this.cloudStorage.updateMetaInfo(...);
}
这会把原本应抛出的 NullPointerException 静默吞掉,属于行为改变。已删除该判断(CloudStorageService.java:161)。
3.3 BaseFile.setExtra():多出原始字节码没有的 value != null
原始 lambda$setExtra$0 的字节码开头是:
aload_2
arraylength
ifle 44
没有 ifnull,即原始代码直接访问 value.length。项目源码却写成:
if (value != null && value.length > 0 && key.startsWith("extra."))
这会把原本可能出现的 NullPointerException 静默跳过。已删除 value != null &&,恢复原始逻辑(BaseFile.java:122)。
四、缺失的 break / switch 贯穿(4 处)
以下 switch 在原字节码中都有 goto(即源码中的 break),反编译源码漏掉了。虽然当前后续 case 都是空分支,行为没有变化,但源码控制流已不忠实,已补回:
WebSocketSessionManager.java:437:case 109设置 “Site license ready” 后缺少break;OtaFile.java:663:case "mitac-package-type"设置类型后缺少break;QueryHandler.java:397:ENROLL分支末尾缺少break;QueryHandler.java:524:data_usage分支末尾缺少break。
仍有 2 处是原始代码的有意贯穿,未修改:
FileService.clearSite():default处理完文件后贯穿到空 case,统一执行++var7;DeviceProfileApi.deviceGroupRemoved():case 136设置command后贯穿到default的设备循环并返回成功。
五、资源文件缺失 / 不一致(构建产物层面)
反编译只处理了 .class,资源目录有 3 个文件缺失、2 个二进制文件被替换:
| 文件 | 原 WAR | 项目原状态 | 处理 |
|---|---|---|---|
device_apps_service.txt |
8 字节 | 缺失 | 从原 WAR 复制 |
device_service.txt |
8 字节 | 缺失 | 从原 WAR 复制 |
store_ota_service.txt |
8 字节 | 缺失 | 从原 WAR 复制 |
apksigner/apksigner.jar |
440,912 字节 | 181,132 字节(不同版本) | 用原 WAR 版本覆盖 |
static/module/angular-filter/angular-filter.zip |
SHA-256 不同 | 内容被改动 | 用原 WAR 版本覆盖 |
修复后 src/main/resources 与 WEB-INF/classes 的非 class 资源 2,722 个文件哈希全部一致。
另外,.gitignore 里的 *.zip 规则会忽略 angular-filter.zip,已补充 !src/main/resources/static/**/*.zip,避免该静态资源在提交时再次丢失。
六、Maven 依赖缺失
源码直接引用了 Batik 和 BouncyCastle,但 pom.xml 未声明;用原 WAR 的 WEB-INF/lib 编译能通过,纯 Maven 构建会失败:
org.apache.batik.transcoder.*(McApkFile.java)→ 增加batik-transcoder、batik-codec1.16;org.bouncycastle.jce.provider.BouncyCastleProvider、org.bouncycastle.util.encoders.Hex→ 增加bcprov-jdk141.64。
已写入 pom.xml(:159–:176)。
七、验证方法与结果
验证不是“看起来像”,而是逐字节码比较:
- 用原始
WEB-INF/classes和CELL-1.0.0.1.jar作为 ground truth; - 用
javac --release 11重新编译反编译源码; javap -p -c逐方法比较语义操作(方法调用、字段访问、常量、算术、数组、异常抛出等);- 额外比较:注解(含值)、异常表 catch 类型、字段/方法/常量、继承关系、switch case 集合、资源哈希。
| 检查项 | 结果 |
|---|---|
| Java 编译 | 271 文件,0 error |
| com.midm 类覆盖 | 246 / 246 |
| com.midm 方法语义一致 | 3,583 / 3,599(其余 16 个为编译器版本差异) |
| CELL 类覆盖 | 89 / 89 |
| CELL 方法语义一致 | 878 / 883(其余 5 个为编译器版本差异) |
| 注解差异 | 0 |
| 异常表差异 | 0 |
| 字段 / 方法 / 常量 / 继承差异 | 0 |
| switch case 差异 | 0 |
| 资源文件差异 | 0(修复后 2,722 / 2,722) |
剩余 16 + 5 个“差异”均为 javac 11 与 javac 18 的代码生成差异,不是源码语义差异:
- 12 个枚举类的
<clinit>:javac 11 直接anewarray + putstatic,javac 18 生成$values()辅助方法; LicenseModel.Period.toString():javac 11 用StringBuilder,javac 18 用invokedynamic makeConcatWithConstants;DeviceLicense.activate()、SettingsService.getInt():三元表达式装箱/拆箱指令不同;ReportService.generateDeviceReport():iadd与iinc的循环自增优化不同。
验证环境说明
- 已安装 Apache Maven 3.9.9(
D:\Software\apache-maven-3.9.9),并写入用户MAVEN_HOME、M2_HOME与PATH; - 已安装 MongoDB Community 7.0.14 便携版(
D:\Software\mongodb-7.0.14); - 已执行
mvn clean package -DskipTests,BUILD SUCCESS,产物target/midm-1.1.1.12.war(约 149 MB); - 已实际启动 Spring Boot:
Started MainApplication,http://127.0.0.1:8080/返回登录页 200,/dpc/qr返回image/png。
八、仍可改进但无行为影响的部分
- 已清除全部
var10000/var10001等 Fernflower 临时变量(约 48 处),改为直接表达式或语义化局部变量; - 已把两处有意 switch 贯穿标注
@SuppressWarnings("fallthrough")并加注释,-Xlint不再报 fallthrough; - 已修正
MainApplication的new Class[]{...}与SiteService的裸Class[]; javac -Xlint:all仍有 1,253 条警告:498 unchecked、408 cast、326 rawtypes、14 serial、4 overrides、3 deprecation。- 主要是局部变量仍保留裸类型(例如
List list = ...)、反编译器补的冗余 cast; - 不影响运行行为,若要追求“零警告”,可以再逐文件恢复局部变量泛型。
- 主要是局部变量仍保留裸类型(例如
九、环境配置与运行验证(2026-11-16 补充)
| 项目 | 结果 |
|---|---|
| Maven | 3.9.9,已配置代理/阿里云 mirror,mvn -v 正常 |
| JDK | Amazon Corretto 18.0.2(JAVA_HOME 已设置;编译目标 --release 11) |
| MongoDB | Community 7.0.14,监听 127.0.0.1:27017 |
| 构建 | mvn clean package -DskipTests → BUILD SUCCESS |
| 启动 | java -jar target/midm-1.1.1.12.war → Started in 5.7s |
| 登录页 | GET / → 200 text/html |
| DPC 二维码 | GET /dpc/qr → 200 image/png |
| 运行日志错误 | 0 ERROR / 0 Exception |
| 清理后语义复验 | 3,583 / 3,599 方法仍完全一致(16 个编译器版本差异不变) |
启动时踩到并已修复的环境问题:PropertiesConfig 会强制读取
C:\ProgramData\MiDM\midm.properties,目录/文件不存在时直接启动失败。已创建该文件并写入
单机 Mongo 配置(mongo.replica_set= 为空)。
附:本次修改涉及的关键文件
src/main/java/com/midm/service/BaseService.java:<T>方法签名、PageImpl<T>src/main/java/com/midm/app/DbConfig.java:恢复两段超时参数块src/main/java/com/midm/service/cloudStorage/CloudStorageService.java:删除多余 null 判断src/main/java/com/midm/service/file/FileService.java:category、switch 作用域src/main/java/com/midm/service/file/ReportService.java:groupOptionsrc/main/java/com/midm/app/DbInitialize.java:两个索引遍历循环src/main/java/com/midm/service/ExternalApiService.java:failureResultsrc/main/java/com/midm/webservice/device/DeviceApi.java:deviceLicensepom.xml:Batik / BouncyCastle 依赖src/main/resources/apksigner/apksigner.jar等资源