Module Federation与Garfish微前端集成问题解析

问题背景

在使用Modern.js框架开发应用时，当同时配置Module Federation和Garfish微前端方案时，控制台会抛出"remoteEntryExports.get is not a function"的错误。这种情况通常发生在尝试将两种不同的模块共享机制混合使用时。

技术原理分析

Module Federation和Garfish虽然都涉及模块共享和远程加载，但它们的实现机制存在本质差异：

1. Module Federation是Webpack/Rspack提供的原生模块联邦方案，通过共享依赖和远程模块来实现微前端架构
2. Garfish是一套完整的微前端解决方案，包含沙箱隔离、样式隔离、路由管理等完整功能

当两者同时启用时，Modern.js内部的模块加载机制会出现冲突，导致无法正确识别远程模块的导出方式。

解决方案建议

对于这种情况，开发者有以下几种选择：

1. 纯Module Federation方案：移除Garfish配置，完全使用Module Federation实现微前端架构
2. 纯Garfish方案：移除Module Federation配置，使用Garfish提供的完整微前端能力
3. 桥接方案：如果确实需要同时使用，可以考虑通过框架桥接层来协调两种机制

最佳实践

根据实际项目需求，建议采用以下策略：

• 如果是新项目，优先考虑Module Federation方案，这是现代构建工具原生支持的方案
• 如果需要完整的沙箱隔离能力，可以选择Garfish方案
• 避免在同一项目中同时启用两种机制，除非有特殊需求且了解底层原理

配置调整示例

如果选择Module Federation方案，可以调整modern.config.ts配置如下：

import { appTools, defineConfig } from "@modern-js/app-tools";

export default defineConfig({
  runtime: {
    router: true,
  },
  plugins: [
    appTools({
      bundler: "rspack",
    }),
  ],
  tools: {
    rspack: (config, { rspack, appendPlugins }) => {
      config.output.publicPath = "auto";
      appendPlugins([
        new rspack.container.ModuleFederationPlugin({
          name: "host",
          remotes: {
            provider: "provider@远程地址",
          },
          shared: {
            react: { singleton: true, eager: true },
            "react-dom": { singleton: true, eager: true },
          },
        }),
      ]);
      delete config.optimization?.splitChunks;
      delete config.optimization?.runtimeChunk;
    },
  },
});

总结

在现代前端架构设计中，Module Federation和微前端方案各有优势。开发者需要根据项目具体需求选择合适的方案，避免混合使用导致的技术冲突。理解底层原理有助于做出更合理的技术选型决策。