Angular+Nx+Module Federation：相同配置构建产物差异问题求助

可能的原因及排查步骤 #

1. 依赖版本不匹配 #

• 核对主项目与POC的@angular-architects/module-federation、nx核心包版本是否完全一致。Module Federation的行为高度依赖该插件版本，哪怕小版本差异都可能导致构建产物逻辑变化。
• 对比两者package.json中所有Angular、Nx、Module Federation相关依赖的版本，若存在差异，删除主项目的node_modules和锁文件（package-lock.json/yarn.lock）后重新安装依赖。

2. 构建配置的隐性差异 #

• 检查主项目对应Shell/Remote项目的project.json，对比POC的构建目标（targets.build）配置：
  • 确认builder是否一致（应为@angular-architects/module-federation:build或Nx集成的对应builder）
  • 查看options中的optimization、splitChunks、outputPath等参数，主项目可能开启了额外的分包优化规则，覆盖了Module Federation的默认chunk生成逻辑。
• 检查主项目是否存在自定义webpack.config.js，是否有修改chunk命名、分割策略的配置，导致Remote模块的chunk无法被Shell正确识别。

3. 路径配置的干扰 #

• 主项目tsconfig.base.json中新增的路径配置（compilerOptions.paths）可能改变模块解析逻辑。如果Remote项目暴露的模块路径与主项目的paths规则匹配，会被解析为主项目本地文件，而非通过Federation加载。
• 验证Shell项目中导入Remote模块的路径是否正确，确保没有被本地paths规则拦截。

4. Nx缓存或工作区配置残留 #

• 尽管执行了缓存清理，尝试执行nx reset彻底清除Nx全局缓存和本地项目缓存，再重新构建。
• 检查主项目是否存在项目级的nx.json或workspace.json配置，是否修改了构建的依赖分析、缓存策略等逻辑。

5. Angular小版本兼容问题 #

• 主项目使用Angular 18.0.3，POC为18.0.2，小版本差异可能导致Angular构建工具的chunk生成逻辑变化，与Module Federation插件出现兼容性问题。可尝试将主项目Angular版本降级至18.0.2，验证是否恢复正常。

内容的提问来源于stack exchange，提问作者Ron Jonk