# 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 的代码生成差异**(枚举 ``、字符串拼接、装箱、`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`(方法级 `` 丢失) - `DeviceService.java:229: Object cannot be converted to Device`(`List` 变成裸 `List`) - `FileService.java:169: Object cannot be converted to UUID` - `DateConverter.java: 不是抽象类,未覆盖 convert`(`implements Converter` 变成裸 `Converter`) - `ProfileApps.java: List cannot be converted to List`(通配符捕获) - `DbObject.java: Map cannot be converted to Map` **修复方式**:对每个类用 `javap -p -s` 读出原始 `Signature`,按“方法名 + 参数个数 + 参数类型”对齐,恢复: - 类/方法类型参数,如 `public T findById(Class, Object)`; - 返回值与参数泛型,如 `List`、`PageImpl`、`Converter`; - 字段泛型,如 `List sites`; - 必要处补回 `Class`、`Collection` 等。 共修改 **114 个 Java 文件、约 560 处签名**,并补回 4 个文件缺失的 import。 --- ## 二、变量作用域 / 重名 / 丢失(17 errors) Fernflower 在 switch、try/catch、lambda 等场景把不同作用域的变量重名,或直接漏掉声明。已逐处对照 `LocalVariableTable` 和字节码修复: | 文件 | 问题 | 修复 | | --- | --- | --- | | `SettingsService.java:257` | `settingsMap.put(key, (Object)null)` 与 `Map` 不兼容 | `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` 未定义、`Map` 构造器通配符不兼容 | 裸 `List` + `super((Map)map)` | | `GeneralProfile.java` | ` T getProfile(...)` 返回 `Object`/`(Object)null` | 补 `(T)` 转换 | | `NewsMessage.java:94` | 原始 `LinkedTreeMap` 的 `entrySet()` 迭代元素为 `Object` | 先取 `Object`,再显式转 `Map.Entry` | | `StoreApp.java:67` | `Set.addAll(List)` 捕获失败 | 显式 `(Collection)` 转换 | | `UserApi.java:1516` | `List` 传给 `saveUsers(List)` | 显式 `(List)` 转换 | | `McJsonUtils.java:221` | ` T clone(Object)` 泛型推断失败 | 补 `(T)` 转换 | --- ## 三、会改变运行时行为的偏差(3 处) ### 3.1 `DbConfig.getConnectiontString()`:原始字节码中的两段代码被整体丢掉 原始字节码在 `waitqueuetimeoutms` 之后还有: 1. **第二个** `connectTimeoutMS` 判断块(与前面的块重复): ```java if (!params.contains("connectTimeoutMS")) { uriBuilder.setParameter("connectTimeoutMS", String.valueOf(this.connectTimeout)); } ``` 2. 一个 `socketTimeoutMS` 块: ```java if (this.socketTimeout > 0 && !params.contains("socketTimeoutMS")) { uriBuilder.setParameter("", ""); } ``` 反编译源码里这两段完全不存在,意味着连接串的 `connectTimeoutMS` 只设置一次、`socketTimeoutMS` 完全不处理。现已按字节码恢复(`DbConfig.java:191`、`:199`)。 > 注意:第二段用空字符串作为参数名和值,是**原始程序本身的行为**,不是反编译写错;为保持与线上 WAR 完全一致,照原样恢复。 ### 3.2 `CloudStorageService.updateMetaInfo()`:反编译多出一个 null 判断 原始字节码是直接调用: ```java this.cloudStorage.updateMetaInfo(fileName, contentType, paths); ``` 反编译源码却生成: ```java if (this.cloudStorage != null) { this.cloudStorage.updateMetaInfo(...); } ``` 这会把原本应抛出的 `NullPointerException` 静默吞掉,属于行为改变。已删除该判断(`CloudStorageService.java:161`)。 ### 3.3 `BaseFile.setExtra()`:多出原始字节码没有的 `value != null` 原始 `lambda$setExtra$0` 的字节码开头是: ```text aload_2 arraylength ifle 44 ``` 没有 `ifnull`,即原始代码直接访问 `value.length`。项目源码却写成: ```java 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 个枚举类的 ``: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`:`` 方法签名、`PageImpl` - `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` 等资源