模块联邦通过运行时按需加载远程模块,实现微前端应用间的代码共享与独立部署。它利用exposes和remotes配置暴露与导入模块,结合shared机制避免依赖重复加载,支持异步加载、依赖共享及插件化集成,在提升协作效率的同时需注意版本兼容、样式隔离与错误处理等问题。

模块联邦(Module Federation)是 Webpack 5 提出的一种原生支持的微前端实现机制,它让多个独立打包的 JavaScript 应用在运行时动态共享代码,而不需要通过发布私有包或手动集成依赖。它的核心在于“按需加载远程模块”,从而实现跨应用共享组件、工具函数甚至状态管理逻辑。
模块联邦的基本原理
模块联邦允许一个应用(宿主)在运行时从另一个应用(远程)加载模块,就像这些模块本地存在一样。它通过以下机制实现:
- 运行时模块解析:每个应用在构建时声明自己暴露了哪些模块(exposes),以及需要从其他应用导入哪些模块(remotes)。Webpack 在运行时根据配置动态加载远程 chunk。
- 共享依赖管理:通过 shared 配置,多个应用可以协商使用同一版本的库(如 React、Lodash),避免重复加载,减少体积并防止冲突。
- 异步加载与懒执行:远程模块以独立的 bundle 形式存在,通过 HTTP 异步加载,在需要时才初始化执行,不影响主应用启动性能。
典型配置示例
假设有一个容器应用(Host)想使用用户管理应用(Remote)暴露的 UserList 组件。
远程应用(User App)配置:
立即学习“Java免费学习笔记(深入)”;
new ModuleFederationPlugin({
name: 'userApp',
filename: 'remoteEntry.js',
exposes: {
'./UserList': './src/components/UserList',
},
shared: { react: { singleton: true }, 'react-dom': { singleton: true } }
})
宿主应用(Container)配置:
new ModuleFederationPlugin({
name: 'container',
remotes: {
userApp: 'userApp@http://localhost:3001/remoteEntry.js'
},
shared: { react: { singleton: true }, 'react-dom': { singleton: true } }
})
宿主中使用方式:
import UserList from 'userApp/UserList';
function App() {
return (
主应用
);
}
Webpack 会在运行时自动请求 userApp 的 remoteEntry.js,再加载对应的 UserList 模块。
如何实现真正的微前端架构
模块联邦使得每个子应用可以:
- 独立开发部署:各团队使用自己的技术栈、构建流程,只要遵循接口约定即可集成。
- 按需集成功能:页面中某个区域由远程应用提供组件,宿主只需动态 import 即可渲染。
- 共享运行时环境:通过 shared 配置确保 React、Redux 等核心库只加载一次,避免多版本冲突。
- 支持动态插件化:可在运行时根据权限或配置决定加载哪个远程模块,实现插件系统。
实际使用中的注意事项
虽然模块联邦强大,但也需要注意一些问题:
- 版本兼容性:shared 的库建议设置 singleton: true 并严格对齐版本,否则可能引发运行时错误。
- 样式隔离:JS 模块可共享,但 CSS 仍可能冲突,需配合 BEM、CSS-in-JS 或 Shadow DOM 解决。
- 加载顺序与错误处理:远程模块网络失败时需有 fallback 机制,避免阻塞主流程。
- 构建复杂度提升:调试跨应用调用不如单体方便,需完善日志和监控。
基本上就这些。模块联邦不是银弹,但它为微前端提供了一种轻量、高效且原生支持的解决方案,特别适合组织内多个团队协作维护大型前端系统的场景。










