React Native 0.76.5安卓构建报错：解析com.facebook.react.settings插件失败

问题描述 #

创建React Native 0.76.5项目后，构建Android应用时触发以下错误：

FAILURE: Build failed with an exception.

• 位置: 设置文件/Users/apple/Documents/Parth_Shiroya/Git_Projects/Money_book/android/settings.gradle第2行
• 问题详情: 解析插件[id: 'com.facebook.react.settings']失败

  配置项目':gradle-plugin'时出现问题。
  无法从/Users/apple/.gradle/caches/8.10.2/kotlin-dsl/scripts/a076617fd8fe036a177aee239c8987a6/metadata.bin读取工作区元数据

解决方法 #

按优先级尝试以下修复方案：

1. 清理Gradle缓存 #

删除本地Gradle缓存目录，强制重新下载依赖：

rm -rf ~/.gradle/caches

重新执行构建命令：

cd android && ./gradlew clean build

2. 检查settings.gradle配置 #

确认文件中插件引用和仓库配置符合React Native 0.76.x标准：

pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
        maven { url = "$rootDir/../node_modules/react-native/android" }
        maven { url = "$rootDir/../node_modules/jsc-android/dist" }
        google()
    }
    plugins {
        id("com.facebook.react.settings") version "0.76.5" apply false
    }
}

确保插件版本与项目RN版本一致，且包含react-native本地maven仓库。

3. 验证Gradle版本兼容性 #

React Native 0.76.x推荐使用Gradle 8.10.x，检查android/gradle/wrapper/gradle-wrapper.properties：

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

版本不符则修改后重新同步项目。

4. 重装项目依赖 #

删除现有依赖和锁文件后重新安装：

rm -rf node_modules package-lock.json yarn.lock
npm install

进入Android目录同步Gradle：

cd android && ./gradlew sync

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