启动顺序
平台启动时,PluginClassPathLoader 在 Spring 容器之前执行,把 plugins-dist 下的插件 jar 挂到类加载路径上。之后每个应用由独立的 PluginClassLoader 加载,并创建自己的 Spring 子上下文。

为什么不用一个类加载器
十三个应用各自带依赖,版本很难完全对齐。全塞进一个类加载器,先出现的那个版本会赢,另一个应用就在运行期炸 NoSuchMethodError。独立类加载器把这件事隔离掉,代价是兄弟插件的 bean 不能直接注入 —— 跨插件调用只能走 SDK 里按接口取的服务定位器,取不到走降级。
子上下文同理:插件自己的 Controller、Service、Mapper 在自己的容器里,父容器只暴露平台契约。卸载时把子上下文关掉、类加载器释放,才算真的卸干净。
菜单是幂等 upsert
安装时按 route-index.json 与清单里的菜单键做 upsert。这里有个容易忽略的细节:用户改过的菜单名不能被升级覆盖。所以迁移脚本里改文案要用带条件的 UPDATE … WHERE id=… AND label=原种子值,不能无条件刷。

迁移脚本不能改
AppMigrationService 按 (app_code, script) 记账,并保存脚本内容的 LF 归一化 sha256。同名脚本内容一变,安装时直接抛异常拒绝执行 —— 这是有意的:同一个脚本在不同库上产生两种结果,比报错难查得多。
所以已经发出去的迁移,只能加新编号,不能改旧文件。踩过一次:某个包里装了工作副本里未提交的 20 号改动,装到跑过 20 号原版的库上就在校验和这一步硬失败。修法是还原 20 号、新加 21 号做 UPDATE。
装完为什么菜单没立刻出现
多数情况是权限缓存或前端路由缓存没刷,任务中心里那一步会显示「刷新菜单」。另一类是租户维度:应用按租户安装,A 租户装了 B 租户看不到,切租户后要重新拉一次路由。


评论区需要浏览器启用 JavaScript 才能加载。