安装react-native-reanimated后构建失败: :react-native-reanimated:buildCMakeDebug[arm64-v8a]报错

核心修复步骤 #

• 清理缓存并重建项目

  1. 先清理npm缓存与依赖：

     npm cache clean --force
     rm -rf node_modules
     rm package-lock.json
     npm install
     

  2. 清理Android构建缓存并重新编译：

     cd android
     ./gradlew clean
     ./gradlew assembleDebug
     

• 匹配NDK版本
  RN 0.73.4推荐搭配NDK 25.x版本，先在Android Studio的SDK Manager中安装对应NDK，再在android/build.gradle中指定版本：

  buildscript {
      ext {
          ndkVersion = "25.2.9519653"
      }
  }
  

• 调整CMake构建参数
  在android/app/build.gradle的android块中添加配置，限制并行构建数量，避免路径解析冲突：

  android {
      defaultConfig {
          externalNativeBuild {
              cmake {
                  arguments "-DANDROID_STL=c++_shared", "-DCMAKE_BUILD_PARALLEL_LEVEL=4"
              }
          }
      }
  }
  

• 检查路径与权限

  • 确保项目目录和node_modules无权限问题（Linux/macOS下执行chmod -R 755 node_modules）
  • 避免项目路径包含中文或特殊字符，将项目迁移到纯英文路径下

备选方案 #

若以上方法无效，降级react-native-reanimated到适配RN 0.73的稳定版本：

npm install react-native-reanimated@3.3.0 --save

之后重复清理缓存与重建项目的步骤。

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