diff --git a/docs/迁移手册.md b/docs/迁移手册.md index 579668b..732a44a 100644 --- a/docs/迁移手册.md +++ b/docs/迁移手册.md @@ -830,3 +830,10 @@ com.dsasp.* com.eip4.* --- **手册维护说明**:本手册随工程化进展持续更新;新坑位发现即追加,以 `[NEW yyyy-mm-dd]` 标记;章节完成后移除「待补」标记。任何对引擎行为契约的更改必须同步更新第五章并过 code review。 + +### 8.7 ~/.m2 陈旧 SNAPSHOT 毒化 fat jar,模块新代码静默丢失 [NEW 2026-06-12] + +- **现象**:模块源码/模块 jar 都含新类,但 platform-app fat jar 的 BOOT-INF/lib 捆的是旧字节(端点 404)。`mvn -pl platform-app -am package` 反应堆显示 SUCCESS 也不解决。 +- **根因**:某次 `mvn install` 把当时的模块 SNAPSHOT 装进 ~/.m2;此后 spring-boot repackage 解析依赖时优先取 ~/.m2 安装版而非 reactor 产物(离线模式尤甚),新代码永远进不了 fat jar。 +- **对策**:**标准重启口径升级为 `mvn -o -pl platform-app -am clean install -DskipTests`**(install 刷新 ~/.m2 同步);怀疑时核 `unzip -l fat.jar | grep ` 的嵌套 jar 字节数/时间戳与模块 target 比对。 +- **教训**:任何「代码在但运行时 404」先核 fat jar 内嵌套 jar 的新鲜度,再查注解/扫描。