From 4d7bbc6a4271d68d52a5bf9ae7f2100c1f8d179f Mon Sep 17 00:00:00 2001 From: zhengwr Date: Fri, 12 Jun 2026 02:05:45 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=89=8B=E5=86=8C=E7=99=BB=E8=AE=B0=20?= =?UTF-8?q?~/.m2=20=E9=99=88=E6=97=A7=20SNAPSHOT=20=E6=AF=92=E5=8C=96=20fa?= =?UTF-8?q?t=20jar=20=E5=9D=91(=C2=A78.7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- docs/迁移手册.md | 7 +++++++ 1 file changed, 7 insertions(+) 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 的新鲜度,再查注解/扫描。