Module Federation核心库中多环境开发服务器路径问题解析

问题背景

在使用Module Federation核心库与Rsbuild构建工具配合开发多环境应用时，开发者遇到了一个典型问题：在开发服务器模式下，模块联邦(Module Federation)插件生成的文件未能正确按照预期路径提供服务。具体表现为构建阶段输出正常，但在开发服务器运行时，所有环境的联邦模块文件都被错误地合并到了根路径下。

问题现象分析

在构建阶段，项目能够正确生成两个独立环境的输出：

• a环境：dist/a/目录下包含mf-manifest.json等联邦模块文件
• b环境：dist/b/目录下包含mf-manifest.json等联邦模块文件

但在开发服务器模式下，访问/a/mf-manifest.json路径失败，所有联邦模块文件都被错误地合并到了根路径下，只能通过/mf-manifest.json访问，且仅包含a环境的内容。

技术原理探究

这个问题源于开发服务器对多环境构建的特殊处理机制。在标准构建流程中，Rsbuild能够正确处理output.distPath.root配置，将不同环境的输出分离到不同目录。但在开发服务器模式下，这些配置未被正确应用到模块联邦插件生成的文件路径上。

模块联邦插件在开发模式下会生成两类关键文件：

1. 模块清单文件(mf-manifest.json)：记录暴露模块的元数据
2. 异步加载文件：实现模块的动态加载

这些文件默认会基于publicPath配置决定其服务路径。在多环境场景下，需要为每个环境单独配置正确的资源前缀。

解决方案

经过技术专家的深入分析，最终确定解决方案是在每个环境的dev配置中显式设置assetPrefix：

a: {
  dev: {
    assetPrefix: "/a",
  },
},
b: {
  dev: {
    assetPrefix: "/b",
  },
}

这一配置确保了开发服务器能够正确地为每个环境的联邦模块文件提供独立的前缀路径。assetPrefix参数会直接影响开发服务器中所有静态资源的服务路径，包括模块联邦生成的特殊文件。

最佳实践建议

1. 在多环境开发中，务必为每个环境配置独立的assetPrefix
2. 开发环境与生产环境的路径配置要保持一致
3. 对于模块联邦应用，建议在开发初期就验证文件路径是否正确
4. 考虑使用环境变量来动态管理不同环境的路径前缀

总结

这个案例展示了在多环境开发中使用模块联邦时需要注意的关键配置点。通过正确配置assetPrefix，开发者可以确保开发服务器与生产构建保持一致的路径结构，避免因路径问题导致的模块加载失败。这也提醒我们在使用高级构建工具时，需要深入理解其在不同模式下的行为差异。