React Native构建报错：react-native-gesture-handler模块未找到求助

针对你遇到的react-native-gesture-handler module was not found报错，且iOS/Android模拟器均出现、常规手段无效的情况，可以尝试以下针对性步骤：

1. 版本兼容性检查 #

确保react-native-gesture-handler版本与你的React Native版本匹配（比如RN 0.70+需搭配2.0+版本的gesture-handler）。若版本不兼容，卸载重装对应版本：

npm uninstall react-native-gesture-handler
npm install react-native-gesture-handler@对应兼容版本号

2. 验证Android原生配置 #

• 打开android/app/src/main/java/com/[你的项目名]/MainActivity.java，确认导入并重写createReactActivityDelegate方法：

import com.facebook.react.ReactActivityDelegate;
import com.facebook.react.ReactRootView;
import com.swmansion.gesturehandler.react.RNGestureHandlerEnabledRootView;

public class MainActivity extends ReactActivity {
    // 原有代码...
    @Override
    protected ReactActivityDelegate createReactActivityDelegate() {
        return new ReactActivityDelegate(this, getMainComponentName()) {
            @Override
            protected ReactRootView createRootView() {
                return new RNGestureHandlerEnabledRootView(MainActivity.this);
            }
        };
    }
}

• 检查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')

3. 修复iOS原生配置 #

• 彻底重置Pods：

cd ios
pod deintegrate
rm Podfile.lock
pod install

• 确认AppDelegate配置（Swift/OC版本二选一）：
  Swift版AppDelegate.swift：

import UIKit
import React
import RNGestureHandler

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let moduleName = "你的项目名称"
        let rootView = RCTRootView(
            bundleURL: RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index"),
            moduleName: moduleName,
            initialProperties: nil,
            launchOptions: launchOptions
        )
        let gestureRootView = GestureHandlerRootView(frame: UIScreen.main.bounds)
        gestureRootView.addSubview(rootView)
        
        window = UIWindow(frame: UIScreen.main.bounds)
        let rootVC = UIViewController()
        rootVC.view = gestureRootView
        window?.rootViewController = rootVC
        window?.makeKeyAndVisible()
        return true
    }
}

OC版AppDelegate.m：

#import "AppDelegate.h"
#import <React/RCTBridge.h>
#import <React/RCTRootView.h>
#import <RNGestureHandler/RNGestureHandler.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self launchOptions:launchOptions];
    RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge
                                                    moduleName:@"你的项目名称"
                                             initialProperties:nil];

    UIView *gestureRootView = [[GestureHandlerRootView alloc] initWithFrame:[UIScreen mainScreen].bounds];
    [gestureRootView addSubview:rootView];

    self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
    UIViewController *rootVC = [UIViewController new];
    rootVC.view = gestureRootView;
    self.window.rootViewController = rootVC;
    [self.window makeKeyAndVisible];
    return YES;
}

@end

4. 确认入口文件导入顺序 #

在你的项目入口文件（App.js或index.js）最顶部添加导入，确保它早于其他React Native相关导入：

import 'react-native-gesture-handler';
// 其他导入...
import React from 'react';

5. 彻底清理缓存并重建 #

• 清理npm缓存：

npm cache clean --force

• 重置Metro缓存并启动：

npx react-native start --reset-cache

• Android端清理gradle缓存：

cd android && ./gradlew clean
cd .. && npx react-native run-android

• iOS端在Xcode中执行Cmd+Shift+K清理Build文件夹，再重新构建运行。

6. 处理Monorepo或链接异常 #

如果项目是Monorepo结构，尝试手动链接后取消链接，再重新构建：

npx react-native link react-native-gesture-handler
npx react-native unlink react-native-gesture-handler
# 之后重新安装Pods并构建

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