中国 帮助

插件运行时:装了就进路由,卸了就出清单

应用不是启动时 scan 进来的,而是运行期从 plugins-dist 装载的。这篇拆开 PluginClassPathLoader、独立 PluginClassLoader、Spring 子上下文、菜单幂等 upsert 与迁移执行这几件事。

插件运行时:装了就进路由,卸了就出清单

启动顺序

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

a

为什么不用一个类加载器

十三个应用各自带依赖,版本很难完全对齐。全塞进一个类加载器,先出现的那个版本会赢,另一个应用就在运行期炸 NoSuchMethodError。独立类加载器把这件事隔离掉,代价是兄弟插件的 bean 不能直接注入 —— 跨插件调用只能走 SDK 里按接口取的服务定位器,取不到走降级。

子上下文同理:插件自己的 Controller、Service、Mapper 在自己的容器里,父容器只暴露平台契约。卸载时把子上下文关掉、类加载器释放,才算真的卸干净。

菜单是幂等 upsert

安装时按 route-index.json 与清单里的菜单键做 upsert。这里有个容易忽略的细节:用户改过的菜单名不能被升级覆盖。所以迁移脚本里改文案要用带条件的 UPDATE … WHERE id=… AND label=原种子值,不能无条件刷。

b

迁移脚本不能改

AppMigrationService 按 (app_code, script) 记账,并保存脚本内容的 LF 归一化 sha256。同名脚本内容一变,安装时直接抛异常拒绝执行 —— 这是有意的:同一个脚本在不同库上产生两种结果,比报错难查得多。

所以已经发出去的迁移,只能加新编号,不能改旧文件。踩过一次:某个包里装了工作副本里未提交的 20 号改动,装到跑过 20 号原版的库上就在校验和这一步硬失败。修法是还原 20 号、新加 21 号做 UPDATE。

装完为什么菜单没立刻出现

多数情况是权限缓存或前端路由缓存没刷,任务中心里那一步会显示「刷新菜单」。另一类是租户维度:应用按租户安装,A 租户装了 B 租户看不到,切租户后要重新拉一次路由。

THE END

喜欢就支持以下吧

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

回到内容