2022 年我所在的项目,前端是一个 60 万行的单体仓库。三个团队在里面干活:交易、会员、内容。CI 跑一次全量测试四十分钟,发布一周两次,每次发布前要开一个「合并窗口」——因为所有人都得把分支合进来,不然没人知道会不会冲突。最夸张的一次,会员团队重构了登录态模块,交易团队的订单页第二天全挂,而重构的 PR 里只写了「优化鉴权逻辑」。
这种局面下,大家的第一反应通常是「上微前端」。我们讨论了大半年,最后没有立刻上,而是先做了三件事:把目录按业务能力重组、把跨模块的调用改成显式契约、把公共代码收进独立的包。一年之后,只对其中一个真正独立的团队用了微前端。结果比「全量拆」好得多。
这篇讲的就是这个判断过程。重点不在微前端怎么做,而在「边界画在哪」——这件事画错,单体拆成微前端只会把耦合从代码层搬到部署层,更难受。
先分清三种「大」
「项目太大」至少有三种,解法完全不同。搞错类型,投入的钱和时间都会打水漂。
代码量大。行数多但结构清晰,模块之间没啥耦合。这种不需要微前端,只需要好的目录结构和按需加载。我们拆包那一篇讲的就是这个。
团队多。代码可能不算多,但五个团队在一个仓库里,发布节奏、代码风格、优先级都不一样。这是组织问题,答案可能是微前端,也可能只是把发布流程解耦。
变更影响面大。改一处要回归全站,因为共享状态多、隐式依赖多。这是边界问题,最该先解决,而且解决它不需要任何新框架。
我们当时三种都占:60 万行、三个团队、改登录态能挂掉订单页。所以优先级是「先降影响面,再谈拆分」。
约束:为什么不能直接上微前端
| 约束 | 实际情况 | 对方案的影响 |
|---|---|---|
| 团队 | 3 个团队,35 名前端,共用一套设计系统 | 拆成 3 个子应用可行,但共享部分必须有归属 |
| 技术栈 | React 16 与 18 并存,正在迁移 | 微前端可以缓解迁移压力,但会带来双 React 问题 |
| 发布 | 每周两次统一发布,回滚按整站 | 目标是让团队能独立发布,而不是为了技术时髦 |
| 运维 | 没有专职前端运维,部署靠后端平台的流水线 | 多应用意味着多套部署、多套监控,成本要算清 |
| 体验 | 三个业务在同一个页面里互相跳转,共享导航和登录态 | 跨应用通信和路由必须统一设计,否则体验割裂 |
最后一条是关键:我们的业务不是三个独立后台,而是一个用户在同一个站点里连续操作。这决定了微前端不能「各管各的」,必须有主应用负责壳、路由和登录态。这和很多「后台管理系统拆微前端」的场景完全不同。
四种方案,各自的真实代价
A. 继续单体,只做模块化
按业务能力分目录,模块之间只能通过公开入口调用,共享状态收进少数几个 store。好处是零新增基础设施,构建、部署、监控都不变。代价是发布仍然是整站,团队之间仍然要协调时间窗口。
B. iframe 隔离
隔离最彻底:样式、全局变量、路由全互不影响,老系统可以原样塞进来。代价是通信要靠 postMessage、弹窗和遮罩跨 iframe 很别扭、SEO 和性能都差、移动端体验尤其糟。适合嵌入完全不受控的第三方页面,不适合自家业务拆分。
C. 运行时微前端(qiankun 这类)
主应用负责壳与路由,子应用独立构建、独立部署,运行时加载。样式和 JS 有沙箱隔离,通信有约定。代价是沙箱不是银弹,公共依赖容易重复,本地开发要起多个服务,调试链路变长。
D. 构建时共享(Module Federation)
子应用在构建时声明共享依赖,运行时按需加载远程模块。共享粒度更细,可以只共享一个组件而不是整个应用。代价是构建配置复杂、版本协商容易出错,一个远程入口挂掉可能让主应用白屏。
我们最后的路线是 A 打底,对其中一个团队用 C,没有用 D。理由不是 D 不好,而是我们的共享需求主要是「设计系统 + 登录态 + 请求封装」,这三样用包共享就够了,不需要运行时协商。引入 Federation 只会多一层构建复杂度,收益有限。
先做分层:这一步没有技术风险,只有纪律成本
我们把代码按「依赖方向」分成四层。注意不是按技术分(组件、工具、页面),而是按「谁可以依赖谁」分。
规则只有四条,写在 lint 配置里强制执行:应用层可以依赖领域层;领域层之间禁止直接 import 对方的内部文件,只能走对方的 index.ts;能力层和基础层不许 import 领域层;同一层内部禁止循环依赖。
这四条规则听起来很朴素,但它们把「改登录态挂掉订单页」这类问题从「可能发生」变成「构建时失败」。我们花了大约三周清理违规,之后同类事故基本消失。
// 领域模块的公开契约:只导出允许外部使用的东西
// domains/trade/index.ts
export { createOrder } from "./api/create-order";
export { OrderSummaryCard } from "./components/order-summary-card";
export type { Order, OrderStatus } from "./types";
// 内部的 store、工具、组件一律不导出
// 用 ESLint 卡住跨领域深层引用
"no-restricted-imports": ["error", {
"patterns": [{
"group": ["@/domains/*/!(index)"],
"message": "领域模块只能从 index.ts 导入,不要直接引用内部文件"
}]
}]
什么时候才值得上微前端
我们给自己定了三个条件,全部满足才拆:
第一,团队有独立的发布诉求,而且真的被阻塞过。不是「理论上想独立」,是「上个月因为等另一个团队,晚了三天上线」。有具体损失,才值得为拆分付成本。
第二,业务边界足够清晰,能画出独立的页面集合。如果两个团队天天改同一个页面,拆成两个应用只会让这个页面更难改。我们的内容团队有自己的页面集合,交易和会员则高度交织,所以只拆了内容。
第三,有人能维护这套基础设施。主应用、沙箱、公共依赖、部署流水线、监控串联,这些加起来至少是半个人力。没人管,半年后就是一团谁都看不懂的配置。
反过来,如果团队少于三个、或者大家还在同一个发布窗口里协作得很顺畅,微前端带来的复杂度会超过收益。这条线不是技术线,是组织线。
拆了之后真实踩的坑
内容团队拆出去之后,第一周就遇到了样式污染,第二周遇到双 React,第三周遇到路由冲突。下面这张表是我们半年内修过的问题,按出现频率排。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 子应用样式污染主应用,或反过来 | 全局选择器、CSS 变量作用域、z-index 没有约定 | 看子应用是否开启了样式隔离;搜全局选择器和 :root |
| 页面里加载了两份 React,hooks 报错 | 子应用自带框架依赖,没有走共享 | 产物分析里数 React 副本;检查 shared 配置 |
| 子应用升级后主应用白屏 | 远程入口加载失败,或共享模块版本不兼容 | 看网络面板里子应用入口的状态;查主应用有没有兜底 |
| 子应用路由和主应用冲突 | 路由前缀没约定,History 模式互相覆盖 | 看路由注册表与 basename,确认前缀唯一 |
| 本地开发要起五个服务 | 拆分后没有独立运行能力,强依赖主应用 | 检查子应用能否单独启动并 mock 主应用能力 |
| 发布顺序出错,页面 404 | 主应用和子应用的资源清单没协调 | 查部署流水线顺序与版本记录 |
| 线上报错定位不到是哪个应用 | 监控没有串联 traceId 和应用标识 | 看上报字段里有没有 app 名与同一会话 ID |
样式隔离是最容易被低估的一项。沙箱能隔离 JS 全局变量,但 CSS 的作用域问题没那么容易解决:子应用的 :root 变量会影响主应用,主应用的全局 reset 会影响子应用,第三方组件的 z-index 能盖住主应用的弹窗。我们的做法是约定「子应用不使用全局选择器,所有样式挂在应用根节点下」,再配合构建时的作用域插件。这不是框架能替你决定的事。
双 React 的问题也一样。微前端框架通常提供共享依赖的机制,但前提是你把框架声明为共享且版本兼容。只要有一个子应用坚持用自己的 React 版本,运行时就会出现两份,症状是 Invalid hook call,而且只在特定页面出现。解决方法是把 React 提到主应用统一提供,子应用只声明 peer 依赖。
跨应用通信是我们花时间最多的地方。最开始想得很简单:主应用往下传 props,子应用往上抛事件。真正跑起来才发现,很多东西不在 props 的传递路径上,比如「用户切换了组织」「权限变了」「购物车数量更新」。这些状态如果每个子应用各存一份,迟早会不一致。我们最后只保留两类通信:一是主应用提供的只读上下文(用户、权限、租户、主题),通过统一的注入接口下发;二是事件总线,只用于「发生了什么」的通知,不用于传状态。事件里不带大对象,需要数据就回主应用查。这条约束听起来保守,但它避免了「两个应用各有一份真相」这种最难排查的问题。
部署顺序也比想象中重要。主应用先发、子应用后发,中间会有一段时间主应用引用了还不存在的子应用版本;反过来,子应用先发、主应用后发,旧主应用可能加载到新子应用的接口,字段对不上。我们的做法是子应用向后兼容至少一个版本,主应用维护一份「子应用可用版本清单」,加载失败时降级到上一个版本,而不是白屏。清单本身是静态 JSON,跟主应用一起发布,回滚时也一起回滚。
还有一个体验层面的坑:主应用和子应用各自处理路由,容易出现「点浏览器返回,回到了主应用首页而不是上一个子页面」。原因是子应用用的是自己的 history 实例,主应用没有感知。解决方式是把路由统一交给主应用,子应用只负责渲染,路由变化通过主应用广播。代价是子应用不能完全独立运行,需要在本地开发时 mock 一层路由上下文。
组织问题无法用技术解决
有一件事我后来才想明白:微前端能解决「部署独立」,解决不了「职责不清」。如果两个团队的业务边界本来就模糊,拆成两个应用之后,他们仍然会为了同一个交互反复沟通,只是沟通从「改同一份代码」变成了「对齐两个应用的接口」。甚至更麻烦,因为以前还能直接看代码,现在要先看对方的文档。
所以拆分之前,先画一张「页面归属图」:每个页面、每个关键流程,归哪个团队。画不出来,说明组织边界还没想清楚,这时候拆技术架构只是把混乱分散到更多仓库里。
边界与代价:什么时候不划算
团队少于三个,不要上微前端。协调成本低于拆分成本,拆完只会多出一套构建和部署。模块化加 CODEOWNERS 足够。
单体小于十万行,不要拆。这个量级下,构建和测试通常在十分钟以内,按需加载加模块边界就能解决大部分问题。
没有独立发布需求,不要拆。如果所有业务还是每周统一发版,微前端只带来了复杂度,没带来任何好处。
没有基础设施维护人,不要拆。主应用、沙箱、共享依赖、监控、部署,这些是持续投入。半个人力是下限,少了就会腐烂。
强交互页面不要拆到两个应用里。比如一个拖拽配置器,画布、属性面板、素材库如果分属不同子应用,光是状态同步和事件时序就能拖垮体验。微前端的边界应该顺着「页面跳转」画,而不是顺着「组件」画。跨应用通信的成本,远高于同一个进程里的函数调用。
还有一个常被忽略的代价:拆分会让「端到端排查」变难。一个下单失败,可能涉及主应用的登录态、交易子应用的接口、支付子应用的跳转。没有统一的 traceId 和跨应用的日志串联,排查时间会成倍增加。这块的投入要提前算进去。
今天就能动手的五件事
一、画一张依赖图。用 dependency-cruiser 或 madge 生成现有的模块依赖图,重点看三样:循环依赖、跨业务目录的直接引用、被所有人依赖的「上帝模块」。这张图比任何架构文档都真实。
二、量一次影响面。挑最近十次改动,记录每次改了哪些目录、触发了多少测试、涉及几个团队 review。影响面中位数就是你要优化的目标。
三、加一份 CODEOWNERS。按业务目录给每个区域指定负责人,先不强制审批,只观察一个月有多少 PR 跨区域。跨得越多,说明边界越模糊。
四、写一条依赖规则并开启报警。先禁止「领域 A 直接引用领域 B 的内部文件」,只报警不阻断,看一周的违规量。这个数字会告诉你边界到底有没有立住。
五、做一个最小隔离实验。用 qiankun 或 iframe 把一个独立页面挂进主应用,专门测三件事:全局样式是否互染、两边的弹窗能否正常覆盖、路由切换是否互斥。实验成本一天,能帮你判断要不要继续。
小结
大型前端架构的核心不是「拆」,而是「边界」。先让依赖方向可检查,再让发布单元可独立,最后才考虑运行时隔离。微前端是组织工具,不是性能工具,也不是技术升级的捷径。
架构拆开之后,还有一个副作用很少被提前想到:攻击面变大了。多一个子应用就多一套构建、多一份第三方依赖、多一个可以加载远程代码的入口。下一篇讲前端安全,正好接住这个新问题。