React Native Testing Library 中 __fbBatchedBridgeConfig 错误的深度解析

问题背景

在使用 React Native Testing Library 进行组件测试时，开发者可能会遇到一个令人困惑的错误："__fbBatchedBridgeConfig is not set, cannot invoke native modules"。这个错误通常出现在测试环境配置不正确的情况下，特别是在复杂的项目结构中。

错误本质

这个错误表明 React Native 的桥接配置没有被正确设置，导致无法调用原生模块。在测试环境中，这通常意味着 React Native 的测试基础设施没有被正确初始化。

常见触发场景

1. 多版本 React Native 冲突：在 monorepo 项目中，如果不同子项目使用了不同版本的 React Native，可能会导致版本冲突。

2. 缺少关键依赖：项目中可能缺少 react-test-renderer 这样的关键测试依赖。

3. 配置不完整：Jest 配置可能没有正确处理 React Native 相关的转换规则。

解决方案

1. 确保依赖一致性

在 monorepo 项目中，确保所有子项目使用相同版本的 React Native 是解决问题的关键。可以通过以下方式实现：

• 在根目录的 package.json 中固定 React Native 版本
• 使用 yarn workspaces 或 lerna 的 hoisting 功能时，注意版本冲突问题
• 考虑使用 nohoist 配置来避免模块提升导致的冲突

2. 完善测试依赖

确保项目中包含所有必要的测试依赖：

• react-test-renderer（版本应与 React Native 版本匹配）
• @testing-library/react-native
• jest 及其相关配置

3. 正确配置 Jest

Jest 配置需要特别处理 React Native 相关的模块转换。一个典型的配置应包括：

module.exports = {
  preset: 'react-native',
  setupFilesAfterEnv: ['./jest.setup.js'],
  transformIgnorePatterns: [
    'node_modules/(?!((jest-)?react-native|@react-native(-community)?)|expo(nent)?|@expo(nent)?/.*)'
  ]
};

最佳实践

1. 隔离测试环境：为每个子项目创建独立的测试环境，避免依赖冲突。

2. 版本对齐：保持 React、React Native 和测试工具链版本的兼容性。

3. 渐进式测试：从简单组件开始测试，逐步增加复杂度，便于定位问题。

4. 持续集成检查：在 CI 环境中设置测试流程，及早发现环境配置问题。

总结

"__fbBatchedBridgeConfig is not set" 错误通常反映了 React Native 测试环境的基础配置问题。通过确保依赖版本一致性、完善测试工具链和正确配置 Jest，可以有效地解决这类问题。在复杂的项目结构中，特别是 monorepo 环境下，需要特别注意模块版本管理和环境隔离。