Webpack中怎么使用ModuleFederation模块联邦实现多个独立微前端应用之间的代码共享与运行时依赖共享

舞夢輝影

舞夢輝影

2026-07-20

540人浏览

原创

module federation 不是自动互通的魔法开关,而是需 host 与 remote 协同配置的运行时加载机制:remote 通过 exposes 暴露模块,host 通过 remotes 声明地址并导入;双方 name 必须唯一,shared 依赖(如 react/react-dom)须显式配置 singleton: true 且 eager: true,remoteentry.js 路径需可访问且 cors 开放,组件导出与消费须符合 react 运行时规范。

webpack中怎么使用modulefederation模块联邦实现多个独立微前端应用之间的代码共享与运行时依赖共享

Module Federation 不是“自动互通”的魔法开关,而是需要宿主与远程双方协同配置的运行时加载机制。它让独立部署的应用能按需加载彼此暴露的组件和共享依赖,但关键在配置细节是否对齐。

明确角色分工:Host 与 Remote 各司其职

一个应用不能同时“既消费又提供”而不做区分——必须明确定义谁是 Host(主容器),谁是 Remote(被加载方)。

  • Remote 应用需配置 exposes,声明哪些模块可被外部使用,例如:./Button./src/components/Button.jsx
  • Host 应用需在 remotes 中写明远程应用的唯一 name 和其 remoteEntry.js 地址,格式为 remoteName@http://host:port/remoteEntry.js
  • 双方 name 字段必须唯一且不重复;若 Host 的 name 是 mainApp,Remote 的 name 就不能也叫 mainApp,否则运行时注册冲突

共享依赖必须显式声明且策略一致

React、React DOM 等核心库若未正确共享,会直接触发 Invalid hook call 或上下文丢失。shared 配置不是“写个名字就行”,而要控制版本、加载时机和实例唯一性。

面向设计的AXUI前端框架表单
面向设计的AXUI前端框架表单

面向设计的AXUI前端框架表单是一款包含表格、列表、弹窗等的AXUI前端框架表单下载。

下载
  • reactreact-dom 必须成对设置 singleton: trueeager: true,确保它们在应用启动时就加载并全局唯一
  • requiredVersion 是硬性约束,不是语义化范围;例如设为 '^18.2.0',但本地 node_modules 实际装的是 18.1.0,Webpack 就会降级使用本地副本,导致双 React 实例
  • 工具类库如 lodash-es 可设 singleton: false,但要注意命名空间是否安全——只要都用 import { debounce } from 'lodash-es' 就没问题;若某方做了 export * as Lodash from 'lodash-es',就可能覆盖全局导出

确保 remoteEntry.js 可访问且路径准确

Host 加载失败,90% 源于 remoteEntry.js 获取环节卡住,而非代码逻辑问题。

  • Remote 服务必须开启 CORS,否则浏览器直接拦截请求,控制台报 Cross-Origin Request Blocked
  • 检查 http://localhost:3002/remoteEntry.js 是否真能返回 JS 文件(HTTP 200 + Content-Type: application/javascript),而不是 404 或 HTML 页面
  • Remote 的 filename: 'remoteEntry.js' 对应构建后输出路径,需确认静态资源托管位置(如 Nginx 的 root 或 Vite 的 base)是否匹配 URL 路径

远程组件导入要符合 React 运行时规范

即使 remoteEntry 加载成功,组件仍可能报 type is invalid,常见原因是导出或消费方式不合规。

  • Remote 导出必须是具名或默认函数组件,不能包裹在异步逻辑里(比如 const Button = () => import('./Button') 是错的)
  • Host 端导入后,需确保组件运行环境具备必要上下文,例如远程组件用了 useRouter,但 Host 没提供 RouterProvider,就会崩溃
  • 推荐在 Remote 中将组件包装一层轻量 Provider(如最小化的 RouterProviderQueryClientProvider),或约定 Host 统一注入基础 Context

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1062

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2187

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2080

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2229

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

333

5

js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2364

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

717

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

2181

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

637

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webpack4.x---十天技能课堂
Webpack4.x---十天技能课堂

共20课时 | 1.9万人学习

两小时学会 Webpack
两小时学会 Webpack

共14课时 | 2万人学习

Node.js-前端工程化必学
Node.js-前端工程化必学

共19课时 | 3.4万人学习