Files
mdm/DECOMPILATION_AUDIT.md
T
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

268 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 判断块(与前面的块重复):
```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 个枚举类的 `<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` 等资源