Files
mdm/DECOMPILATION_AUDIT.md
rick 10aa1829f5 fix: repair decompiled sources and add exhaustive documentation
- 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
2026-11-16 17:28:23 +08:00

14 KiB
Raw Permalink Blame History

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 个文件。根因不是业务代码写错,而是反编译时丢失了泛型签名、变量作用域和部分语句。

本次审计以原始字节码为唯一基准,完成了:

  1. 从字节码恢复 114 个 Java 文件的泛型/方法签名(约 540 处);
  2. 修复 17 处变量重名、变量丢失、通配符捕获等反编译缺陷;
  3. 发现并修复 3 处会改变运行时行为的偏差(DbConfig 丢失代码块、CloudStorageService 多出 null 判断、BaseFile 多出 null 判断);
  4. 修复 4 处缺失的 break,补齐 3 个丢失的资源文件,替换 2 个不一致的二进制资源;
  5. 补齐 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 UUID
  • DateConverter.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 之后还有:

  1. 第二个 connectTimeoutMS 判断块(与前面的块重复):
if (!params.contains("connectTimeoutMS")) {
   uriBuilder.setParameter("connectTimeoutMS", String.valueOf(this.connectTimeout));
}
  1. 一个 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-codec 1.16;
  • org.bouncycastle.jce.provider.BouncyCastleProvider、org.bouncycastle.util.encoders.Hex → 增加 bcprov-jdk14 1.64。

已写入 pom.xml(:159–:176)。


七、验证方法与结果

验证不是“看起来像”,而是逐字节码比较:

  1. 用原始 WEB-INF/classes 和 CELL-1.0.0.1.jar 作为 ground truth;
  2. 用 javac --release 11 重新编译反编译源码;
  3. javap -p -c 逐方法比较语义操作(方法调用、字段访问、常量、算术、数组、异常抛出等);
  4. 额外比较:注解(含值)、异常表 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:groupOption
  • src/main/java/com/midm/app/DbInitialize.java:两个索引遍历循环
  • src/main/java/com/midm/service/ExternalApiService.java:failureResult
  • src/main/java/com/midm/webservice/device/DeviceApi.java:deviceLicense
  • pom.xml:Batik / BouncyCastle 依赖
  • src/main/resources/apksigner/apksigner.jar 等资源