NX Monorepo中Module Federation首个Remote模块加载失败问题

1. 检查Module Federation配置冲突 #

• 确认新增Data模块的module-federation.config.js或nx.json中的MF配置，是否占用了Map模块的4202端口，或修改了全局的manifest生成逻辑。
• 核对Host应用的module-federation.manifest.json，确保Map模块的地址未被意外覆盖——新增模块后，manifest生成脚本可能错误重置了原有Remote的配置项。

2. 验证Remote服务可用性 #

• 手动访问http://localhost:4202/remoteEntry.mjs：
  • 若返回404，说明Map模块服务未启动或端口被修改，检查该模块project.json中targets.serve.port配置。
  • 若返回内容异常，查看Map模块的MF打包配置，确认exposes字段是否正确，打包过程是否有报错。

3. 清理缓存与检查依赖冲突 #

• 执行nx reset清理NX缓存，再重新构建所有Remote模块和Host应用，避免缓存导致的配置不生效。
• 检查Data模块的package.json，确认是否引入了与Map模块冲突的依赖（比如不同版本的@module-federation/runtime或NX相关包），这类冲突会导致运行时加载逻辑异常。

4. 排查动态加载逻辑 #

• 检查Host中动态加载Remote路由的代码，确认新增模块后路由匹配逻辑是否出错，比如路由路径与模块的映射关系被意外修改。
• 核对动态导入的模块名称，确保没有出现“模块名称与端口不匹配”的错误（比如误把Data模块的名称指向Map的端口）。

5. 检查端口占用与服务启动顺序 #

• 检测4202端口是否被其他进程占用：Windows用netstat -ano | findstr :4202，Linux/macOS用lsof -i :4202。
• 确保启动顺序正确：先启动所有Remote模块，再启动Host，避免Host加载时Remote服务尚未就绪。

6. 查看详细错误日志 #

• 打开浏览器开发者工具的控制台和网络面板：
  • 查看remoteEntry.mjs加载时的具体网络错误（如CORS、500状态码）。
  • 检查控制台中的完整堆栈信息，定位加载失败的深层原因。

内容的提问来源于stack exchange，提问作者mat.hudak