NX Monorepo React Native添加Tab导航遇RNGestureHandlerModule缺失错误

针对你遇到的Invariant Violation: TurboModuleRegistry.getEnforcing(...): 'RNGestureHandlerModule' could not be found错误，按以下步骤排查解决：

1. 在项目入口顶部导入手势处理初始化代码 #

react-native-gesture-handler需要在所有React Native组件之前导入初始化代码，否则会导致原生模块无法注册。

修改你的App组件文件，在最顶部添加：

import 'react-native-gesture-handler';

确保这行代码在import React from 'react'和其他RN组件导入之前。

2. 确保导航容器包裹在GestureHandlerRootView中 #

自定义的AppNavigationContainer必须用GestureHandlerRootView包裹，这是react-navigation依赖手势处理的必要条件。检查你的导航组件实现：

// @NxDemo/navigation/src/AppNavigationContainer.tsx
import { GestureHandlerRootView } from 'react-native-gesture-handler';
import { NavigationContainer } from '@react-navigation/native';

export const AppNavigationContainer = ({ children }) => {
  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      <NavigationContainer>{children}</NavigationContainer>
    </GestureHandlerRootView>
  );
};

3. 修复Monorepo下的原生依赖链接 #

NX Monorepo的自动链接可能存在路径问题，手动验证并修复：

iOS #

• 进入项目的ios目录，删除Pods文件夹和build文件夹：

  rm -rf Pods build
  

• 重新安装Pod依赖：

  pod install
  

Android #

• 检查android/settings.gradle文件，确认包含以下内容：

  include ':react-native-gesture-handler'
  project(':react-native-gesture-handler').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-gesture-handler/android')
  

• 检查android/app/build.gradle的dependencies块，确认包含：

  implementation project(':react-native-gesture-handler')
  

• 进入android目录，清理构建缓存：

  ./gradlew clean
  

4. 调整Metro配置适配Monorepo #

在metro.config.js中，添加根目录的node_modules到watchFolders，确保Metro能正确解析跨包的依赖：

const path = require('path');

module.exports = withNxMetro(mergeConfig(defaultConfig, customConfig), {
  debug: false,
  extensions: [],
  // 根据你的Monorepo目录结构调整路径，假设当前项目在apps目录下，根目录在上级
  watchFolders: [path.resolve(__dirname, '../../node_modules')],
});

5. 清除所有缓存并重启服务 #

• 重置Metro缓存并重启：

  npx react-native start --reset-cache
  

• 重新启动iOS/Android模拟器：

  # iOS
  npx react-native run-ios
  # Android
  npx react-native run-android
  

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