React Native安装react-native-gesture-handler后Android构建失败求助

问题分析 #

从错误信息来看，核心问题是自动链接生成的CMake配置文件参数错误，以及Kotlin编译失败，大概率是依赖缓存、版本兼容性或自动链接异常导致。

解决方案 #

1. 彻底清理缓存与重建项目 #

• 删除本地依赖与锁文件：

  # Windows系统
  rmdir /s /q node_modules
  del package-lock.json yarn.lock
  
  # macOS/Linux系统
  rm -rf node_modules package-lock.json yarn.lock
  

• 重新安装依赖：

  npm install
  

• 清理Android构建缓存：

  cd android
  gradlew clean  # Windows
  # ./gradlew clean  # macOS/Linux
  cd ..
  

• 重置React Native缓存并重启服务：

  npx react-native start --reset-cache
  

  之后重新运行npx react-native run-android

2. 调整react-native-gesture-handler版本 #

当前RN 0.76.1与react-native-gesture-handler 2.16.0可能存在兼容性细节问题，尝试切换版本：

• 修改package.json中的依赖版本为：

  "react-native-gesture-handler": "^2.15.0"
  

  或

  "react-native-gesture-handler": "^2.17.0"
  

• 重新安装依赖并清理缓存后重试构建。

3. 手动确认自动链接配置 #

虽然RN 0.60+支持自动链接，但可手动验证配置是否正确：

• 打开android/app/src/main/java/[你的包名]/MainApplication.java
• 导入GestureHandler包：

  import com.swmansion.gesturehandler.react.RNGestureHandlerPackage;
  

• 在getPackages()方法中添加该包：

  @Override
  protected List<ReactPackage> getPackages() {
    @SuppressWarnings("UnnecessaryLocalVariable")
    List<ReactPackage> packages = new PackageList(this).getPackages();
    // 手动添加这一行
    packages.add(new RNGestureHandlerPackage());
    return packages;
  }
  

• 保存后重新构建项目。

4. 删除自动生成的链接配置文件 #

错误指向自动生成的CMake文件异常，可手动删除后重新生成：

• 删除android/app/build/generated/autolinking目录
• 重新运行npx react-native run-android，让系统重新生成正确的链接配置文件

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