模块联邦是Webpack 5实现微前端融合的核心特性,通过remotes和exposes配置实现远程模块动态加载与共享,支持独立部署、依赖优化及双向通信,适用于多团队协作的大型系统,提升架构灵活性与维护性。

Webpack 5 引入的模块联邦(Module Federation)为微前端架构提供了原生支持,使得多个独立的前端应用可以像一个整体一样协同工作,而无需被构建为单一包。它改变了传统微前端依赖运行时集成或 iframe 的方式,实现了真正意义上的代码共享和动态加载。
什么是模块联邦
模块联邦允许一个 Webpack 构建的应用在运行时动态加载另一个 Webpack 构建的应用中的模块。这意味着不同团队开发的独立应用可以共享组件、状态管理逻辑甚至路由,同时保持各自的构建和部署流程独立。
核心是通过 remotes 和 exposes 配置项来定义哪些模块可被远程加载,哪些来自外部应用:
new ModuleFederationPlugin({
name: 'hostApp',
remotes: {
remoteApp: 'remoteApp@http://localhost:3001/remoteEntry.js'
},
exposes: {
'./Button': './src/components/Button',
},
shared: { react: { singleton: true }, 'react-dom': { singleton: true } }
})
如何实现微前端协作
借助模块联邦,微前端不再是简单的页面嵌套,而是模块级的融合:
立即学习“前端免费学习笔记(深入)”;
A3Mall 后端基于 ThinkPHP8 + VUE3 + Element Plus 开发的开源商城系统,前端采用uniapp开发,支持微信公众号商城、H5商城、小程序商城、APP商城、PC商城,前后端源码100%开源,支持免费商用。 功能特性: 遵守MVC设计模式,并且具有明确的model和service层 基于命名空间和PSR-4规范,加入PHP8新特性 内置
- 远程组件加载:主应用可通过 import 动态引入远程应用暴露的 UI 组件,像使用本地模块一样渲染。
-
共享依赖优化:通过
shared配置,避免重复加载 React、Lodash 等公共库,减少打包体积。 - 独立部署与版本控制:每个子应用可独立发布,只要接口兼容,主应用即可无缝使用新版本。
- 双向通信支持:通过共享状态或自定义事件机制,实现主子应用间的数据传递与交互。
实际应用场景
典型落地场景包括大型中后台系统、电商平台等多团队协作项目:
- 企业管理系统中,用户中心由 A 团队维护,订单模块由 B 团队开发,通过模块联邦整合到统一门户。
- 电商平台首页由主站控制,商品推荐、购物车小部件来自不同业务线,实时拼装页面。
- DevOps 平台集成监控、CI/CD、日志等多个子系统,各自独立更新不影响整体稳定性。
注意事项与挑战
虽然模块联邦强大,但也需注意以下问题:
- 确保共享依赖版本兼容,尤其是设置了
singleton: true的库,否则可能导致运行时错误。 - 远程模块的加载时机需处理好异步逻辑,避免白屏或加载失败影响用户体验。
- 调试复杂度上升,需借助 source map 映射和远程 entry 定位问题。
- 生产环境需保证 remoteEntry.js 的高可用,建议配合 CDN 或容错机制。
基本上就这些。模块联邦让微前端从“拼凑”走向“融合”,提升了灵活性和维护性,是现代前端架构的重要演进方向。









