中国 帮助

远程应用前端:怎么避免「双 Vue」

后台前端构建时不可能知道某租户装了哪些应用,所以应用前端产物不能打进宿主 bundle。运行期按后端清单 import() 是唯一解法,但会带来共享依赖重复加载的问题。

远程应用前端:怎么避免「双 Vue」

入口从哪来

后台前端在构建时不可能知道某个租户装了哪些应用。这意味着应用的前端产物不能被打进宿主 bundle,只能在运行期按后端给的清单 import()。

平台把每个应用的入口挂到 /remote-apps/<appCode>/index.js,nginx 用 alias /var/www/remote-apps/ 提供,这个卷和后端释放插件前端产物的目录必须是同一个 —— 后端写、前端读,两边路径对不上就是 404。

a

双 Vue 问题

如果应用产物里也打包了一份 Vue,页面里就会同时存在两个 Vue 实例:组件能渲染,但 provide/inject、全局配置、响应式系统全都不通,最典型的表现是 Element Plus 弹窗挂不上、路由不响应。

解法是共享依赖外置:宿主在构建期生成一份 import map,把 vue、vue-router、pinia、element-plus 这些裸模块名映射到宿主自己暴露的运行时垫片;应用打包时把这些声明为 external,产物里只留对自己组件的引用。构建目录里有一组 gen-runtime-shims.mjs / check-runtime-shims.mjs 脚本专门生成并校验这份映射。

b

缓存要带版本

远程入口不能裸 /remote-apps/<code>/index.js,否则升级后浏览器还拿旧包。清单里带版本参数 ?v=<版本>,版本一变 URL 就变,天然绕过缓存。静态资源那一层同理,内容指纹比固定 ?v=default 靠谱得多。

一个 nginx 坑

location ^~ /remote-apps/ 必须写成前缀匹配并带 ^~。若被后面的正则规则(比如静态资源缓存那条)抢走,请求会按 root /usr/share/nginx/html 找文件,alias 根本不参与,结果就是全 404。这类问题在浏览器里只表现为「应用白屏」,得回到配置里看。

THE END

喜欢就支持以下吧

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

回到内容