升级React Native后启动项目遇Plugin [id: 'com.facebook.react']未找到错误求助

常见修复步骤： #

1. 重装依赖并清理缓存 #

• 删除本地依赖文件夹：rm -rf node_modules（Windows系统执行rd /s /q node_modules）
• 清除包管理器缓存：npm cache clean --force 或 yarn cache clean
• 重新安装依赖：npm install 或 yarn install
• 清理Android构建缓存：
  1. 进入项目android目录：cd android
  2. 执行清理命令：./gradlew clean（Windows系统执行gradlew clean）

2. 同步Gradle配置与RN版本 #

升级RN后需确保Android端Gradle配置同步更新：

• 打开项目根目录的android/build.gradle，确认buildscript的仓库配置包含RN本地maven源：

  buildscript {
      repositories {
          google()
          mavenCentral()
          maven { url("$rootDir/../node_modules/react-native/android") }
      }
      dependencies {
          // 确保gradle插件版本与RN兼容，比如RN 0.7x系列需搭配7.4+版本的插件
          classpath("com.android.tools.build:gradle:7.4.2")
      }
  }
  

• 检查android/settings.gradle是否正确引入ReactAndroid模块：

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

3. 确认RN安装完整性 #

升级过程中可能出现文件缺失，可尝试：

• 重新安装指定版本的RN：npm install react-native@[你的目标版本] --save
• 检查node_modules/react-native/ReactAndroid目录是否存在，且build.gradle文件无损坏

4. 匹配Gradle与RN版本兼容性 #

不同RN版本对Gradle环境有明确要求：

• RN 0.70+ 需Gradle 7.3+、Android Gradle Plugin 7.2+
• 可在android/gradle/wrapper/gradle-wrapper.properties中调整Gradle版本：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
  

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