模块联邦是 Webpack 5 实现微前端的关键技术,允许运行时跨应用共享模块。它通过暴露远程组件(如 UserProfile)并由宿主应用动态加载(import('userApp/UserProfile')),实现子应用独立开发部署。配置中 remote 应用使用 exposes 暴露模块,host 应用通过 remotes 引入远程入口,shared 设置确保公共依赖(如 React)单例共享,避免重复加载。实际应用于企业级多团队协作系统,主应用负责路由与布局,按需加载订单、用户等业务模块,提升灵活性与维护性。优势包括独立部署、减少冗余、提升效率;注意事项有版本兼容、降级处理、remoteEntry.js 可访问性。合理划分边界和统一规范是成功关键。

微前端架构的核心是将大型前端应用拆分成多个独立、可自治的子应用,而模块联邦(Module Federation)是实现这一目标的关键技术之一。它由 Webpack 5 引入,允许不同构建的 JavaScript 应用在运行时共享代码,无需额外打包或发布到 npm 仓库。
什么是模块联邦?
模块联邦让一个 webpack 构建的应用可以暴露部分模块,供其他 webpack 应用动态加载。这意味着:
- 主应用可以在运行时加载并使用远程子应用的组件或函数
- 子应用之间可以共享公共依赖,比如 React 或 Lodash,避免重复加载
- 各团队可独立开发、部署自己的应用,互不干扰
这种机制打破了传统打包时的边界限制,真正实现了“前端微服务”。
基本配置示例
以两个应用为例:一个是容器应用(host),另一个是远程组件应用(remote)。
立即学习“Java免费学习笔记(深入)”;
远程应用(Remote)配置:
new ModuleFederationPlugin({name: "userApp",
filename: "remoteEntry.js",
exposes: {
./UserProfile: "./src/components/UserProfile",
},
shared: { react: { singleton: true }, "react-dom": { singleton: true } }
})
宿主应用(Host)配置:
果酱小店开源电商系统源码是一个模块化的 B2C 社交电商系统,基于当下最热门的开源技术进行构建,后端基于 PHP 框架 Laravel,前端基于微信小程序,vue.js,实现完全的前后端分离。
name: "container",
remotes: {
userApp: "userApp@http://localhost:3001/remoteEntry.js",
},
shared: { react: { singleton: true }, "react-dom": { singleton: true } }
})
宿主应用通过 import('userApp/UserProfile') 就能动态加载远程组件。
在微前端中的实际应用
模块联邦非常适合用于构建基于多团队协作的企业级系统。
- 登录页、导航栏等通用功能可被多个子应用共享
- 每个业务模块(如订单、用户管理)作为独立项目开发部署
- 主应用负责路由整合与布局协调,按需加载对应模块
上线新功能时,只需更新对应子应用,不影响整体系统稳定性。
优势与注意事项
模块联邦带来的主要好处包括:
- 真正的独立部署:各团队可使用不同技术栈和构建版本
- 减少重复打包:通过 shared 配置优化资源体积
- 提升开发效率:本地可通过代理模拟远程模块,支持联调
但也需要注意:
- 确保 shared 依赖版本兼容,尤其是单例(singleton)设置
- 远程模块的加载失败需有降级处理机制
- 构建产物需正确部署并保证 remoteEntry.js 可访问
基本上就这些。模块联邦降低了微前端的实现门槛,让应用间的耦合更松,协作更灵活。关键在于合理划分边界和统一基础规范。不复杂但容易忽略细节。









