使用createAsyncThunk时遭遇'isBatchingLegacy'未定义错误求助

核心原因 #

这个错误本质是Module Federation环境下Redux/Redux Toolkit被多次实例化，导致store内部的上下文引用丢失。当主应用和远程应用分别打包Redux相关依赖时，会出现两个独立的Redux实例，isBatchingLegacy属于Redux核心内部变量，跨实例访问就会触发undefined报错。

具体解决方案 #

1. 统一Redux相关依赖的共享配置 #

在Module Federation配置文件（如webpack.config.js）中，将@reduxjs/toolkit、react-redux、redux设为共享依赖，强制主、远程应用使用同一版本的包：

// webpack.config.js 主应用/远程应用的Module Federation配置
module.exports = {
  plugins: [
    new ModuleFederationPlugin({
      // 主应用配置：name, remotes...
      // 远程应用配置：name, exposes...
      shared: {
        react: { singleton: true, requiredVersion: '^18.2.0' },
        'react-dom': { singleton: true, requiredVersion: '^18.2.0' },
        '@reduxjs/toolkit': { singleton: true, requiredVersion: '^1.9.0' },
        'react-redux': { singleton: true, requiredVersion: '^8.0.5' }, // 匹配RTK 1.9.0对应的react-redux版本
        redux: { singleton: true, requiredVersion: '^4.2.0' } // RTK 1.9.0依赖的redux版本
      }
    })
  ]
};

关键配置：singleton: true确保整个应用只会加载一份依赖实例。

2. 检查TypeScript路径配置 #

如果项目用了paths别名，确保Redux相关包的导入不会指向本地副本：

// tsconfig.json
{
  "compilerOptions": {
    "paths": {
      "@reduxjs/toolkit": ["node_modules/@reduxjs/toolkit"],
      "react-redux": ["node_modules/react-redux"]
    }
  }
}

3. 保证store全局唯一 #

整个应用（主+远程）只能创建一个Redux store实例，远程应用不要单独创建store，直接复用主应用的store上下文：

// 远程应用入口组件，不要单独创建store
import { Provider } from 'react-redux';
import { store } from 'host/store'; // 从主应用共享的store导入

const RemoteApp = () => {
  return <Provider store={store}>{/* 远程应用组件内容 */}</Provider>;
};

4. 清除缓存并重新构建 #

• 删除主、远程应用的node_modules、dist目录
• 重新执行npm install或yarn install
• 重新构建所有应用

额外排查点 #

• 检查package.json，避免重复安装Redux相关依赖（RTK已内置redux，无需单独安装）
• 确认createAsyncThunk语法无误，可添加try/catch捕获异常：

  export const fetchUser = createAsyncThunk(
    'user/fetchUser',
    async (userId: number, { rejectWithValue }) => {
      try {
        const response = await axios.get(`/api/users/${userId}`);
        return response.data;
      } catch (err) {
        return rejectWithValue(err.response.data);
      }
    }
  );
  

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