蓝戒博客

  • 首页
  • 研发说
  • 架构论
  • 效能录
  • AI谈
  • 随笔集
智构苍穹
融合 AI、架构与工程实践,沉淀方法论,构建可持续的技术价值。
  1. 首页
  2. 研发说
  3. 正文

微前端qiankun坑点总结

2022年3月2日 6981点热度 0人点赞 0条评论

背景概述

由于一个后台项目整合了多个系统,并且由多个团队共同维护,项目开发迭代排期及测试、上线的时间节点都不一样,并且后台项目前端代码都在一个git仓库,使得不同团队不同功能代码合并冲突不断并不易统一版本,开发测试也相互影响。其二,项目在同一个服务上代码体积变得越来越大,部署时间变慢。此外相同服务下的公共代码体积也会变大,进而会影响页面加载速度。因此非常有必要将前端微服务化,经过一系列调用及综合项目本身情况,采用微前端框架qiankun,拆分项目为多个微应用,解决上述项目中的痛点问题。

微前端如何解决上述项目中的痛点问题?

1)解构巨石应用:微前端方案,最优先解决的应该就是解构巨石应用。为其解构过程中常会遇到的隔离性、依赖去重、通信、应用编排 等问题提供解决方案。

2)独立仓库、独立开发:不同团队负责单独的微应用,独立的代码仓储,独立开发负责的微应用,相互不影响。

3)独立部署:采用微前端的架构方案,由于各为独立的微应用,所以应用都有自己的持续交付流水线(包括构建、测试并部署到生产环境),并且要能独立部署,不必过多考虑其它代码库和交付流水线的当前状态。

微前端qiankun的一些坑点总结?

1. 静态资源引用问题

问题:静态资源再子应用中相对路径引用,主应用下可能无法读取到

微应用打包之后css中字体和背景图片404 (原因是 qiankun 将外链样式改成了内联样式,但是字体文件和背景图片的加载路径是相对路径。 而 css 文件一旦打包完成,就无法通过动态修改 publicPath 来修正其中的字体文件和背景图片的路径)

解决方案: 小图base64位,大图上传资源服务器,其他资源同样使用绝对路径引用。 

(1).所有图片等静态资源上传至 cdn,css 中直接引用 cdn 地址(推荐)

 (2).借助 webpack 的 url-loader 将字体文件和图片打包成 base64(适用于字体文件和图片体积小的项目)(推荐)

2. 通信数据初始化覆盖问题

// initGlobalState() 的写法会覆盖掉已经初始化定义的一级属性
JavaScript
const { setGlobalState }  = initGlobalState()

解决方案:在统一的位置定义一级属性,将通信方法导出后挂载到window上供全局调用:

JavaScript
const { setGlobalState }  = initGlobalState({
  demoData: '',
  demo2Data: ''
})
window.$setGlobalState = setGlobalState

// 需要通信更新更新demoData处调用示例:
window.$setGlobalState({
  demoData: 'this is demo'
})

3. 静态资源跨域问题

问题:配置的子应用报跨域错误 解决方案:由于 qiankun 是通过 fetch 去获取微应用的引入的静态资源的所以必须要求这些静态资源支持跨域。 如果是自己的脚本,可以通过开发服务端跨域来支持。如果是三方脚本且无法为其添加跨域头,可以将脚本拖到本地,由自己的服务器 serve 来支持跨域。

标签: web技术
最后更新:2025年9月15日

cywcd

我始终相信,技术不仅是解决问题的工具,更是推动思维进化和创造价值的方式。从研发到架构,追求极致效能;在随笔中沉淀思考,于 AI 中对话未来。

打赏 点赞
< 上一篇
下一篇 >

文章评论

razz evil exclaim smile redface biggrin eek confused idea lol mad twisted rolleyes wink cool arrow neutral cry mrgreen drooling persevering
取消回复

cywcd

我始终相信,技术不仅是解决问题的工具,更是推动思维进化和创造价值的方式。从研发到架构,追求极致效能;在随笔中沉淀思考,于 AI 中对话未来。

最新 热点 随机
最新 热点 随机
狂揽 32 万 Star,让 AI 智能体帮你“逆向一切”:深度拆解 GitHub 现象级神器 morluto/rea 与 6 大最佳实践 OpenCode 曝 1.4% 用户密钥失窃,揭秘黑客“对抗性蒸馏”黑产! Claude 全面开放 OTel 追踪、Cohere 鲸吞 500 漏洞猎手:AI 智能体彻底告别“黑盒裸奔”! 不用显卡、普通 CPU 140 毫秒出结果!Mistral 突发开源 209M 时序模型 Timestral,横扫三大权威榜单 Meta Muse 被“开源复刻”?深度拆解 5000 星 OpenMuse:架构很香,但这 3 个暗坑必须看清 智谱 GLM-Legal 反超 Claude 与 Kimi:18B 激活参数凭什么啃下最严苛法律评测?
不讲废话的 AI 估值 2 亿美元!全面拆解“系统一”决策模型 Jev:70ms 极速响应与工业级实战白嫖 10 亿 Token 与云端虚拟机!Meta Muse 国内成功注册保姆级指南:手把手教你跳过排队请3天休13天!我用火山引擎 Seed-2.1-pro搓了个《国庆旅行模拟器》小游戏宿敌破天荒联手!OpenAI 与 Anthropic 互相“查水表”,Google 证实 Agent 越狱渗透:AI 正在失控边缘?波及 13.4 万智能体!首个零点击 RCE 漏洞 Plugin4Shell 爆发:你锁定的插件正在偷偷黑掉你的电脑阿里开源 OpenCodeReview:给大模型套上“工程缰绳”的代码审查神器
单挑变群殴!OpenRouter 祭出 Fusion API,是要把闭源大模型逼上绝路? 60秒《山海经》神战实测:Seedance 2.0 Fast到底是快,还是真的能打? 别再给AI当“擦屁股保姆”了!Ego lite浏览器:真正实现人机“同屏打工”的效率神器 css多行文本溢出显示省略号(…)解决方案 本地电脑能跑多大AI模型?2026本地大模型配置选型实践参考 VideoLingo凭什么敢称“全自动的视频本地化流水线”?
最近评论
cywcd 发布于 4 周前(09月22日) 《牛来跑酷》游戏链接地址已更新: 1. Gemini 3.7 Flash 版 牛来跑酷: htt...
渔夫 发布于 12 个月前(11月05日) 学到了,感谢博主分享
沙拉小王子 发布于 9 年前(11月30日) 适合vue入门者学习,赞一个
沙拉小王子 发布于 9 年前(11月30日) 适合vue入门者学习,赞一个
cywcd 发布于 10 年前(04月27日) 请参考一下这篇文章http://www.jianshu.com/p/fa4460e75cd8

COPYRIGHT © 2025 蓝戒博客_智构苍穹-专注于大前端领域技术生态. ALL RIGHTS RESERVED.

京ICP备12026697号-2