- 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
268 lines
14 KiB
Markdown
268 lines
14 KiB
Markdown
# 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` 等资源 |