React Native新建项目运行Android报错：无法解析com.facebook.react.settings插件

1. 核对RN版本与Gradle插件版本匹配 #

检查android/build.gradle里的React Native Gradle插件配置，确保版本和项目package.json中的RN版本完全一致。比如RN 0.72+版本，要在buildscript的依赖里这样写：

classpath("com.facebook.react:react-native-gradle-plugin:${reactNativeVersion}")

这里的reactNativeVersion要对应你项目里的RN版本号，别硬写错误的固定版本。

2. 替换Gradle镜像源（解决网络拉取失败） #

国内环境下默认maven仓库可能拉取不到Facebook的插件，修改android/build.gradle的仓库配置，添加阿里云镜像：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        mavenCentral()
        google()
    }
    // 保留原有dependencies配置
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        mavenCentral()
        google()
        maven { url "$rootDir/../node_modules/react-native/android" }
        maven { url "$rootDir/../node_modules/jsc-android/dist" }
    }
}

3. 彻底清理Gradle缓存并重新构建 #

执行以下命令做深度清理：

cd android
./gradlew clean
./gradlew build --refresh-dependencies
cd ..
npx react-native run-android

也可以手动删除android/.gradle、android/app/build文件夹后再重新构建。

4. 重新安装项目依赖 #

删除项目根目录的node_modules和锁文件，重新安装：

rm -rf node_modules package-lock.json
npm install

安装完成后再试npx react-native run-android。

5. 确认Gradle版本与RN兼容 #

查看android/gradle/wrapper/gradle-wrapper.properties里的Gradle版本，确保符合RN版本要求。比如RN 0.72+建议用Gradle 7.5+，修改distributionUrl：

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

内容的提问来源于stack exchange，提问作者srikanth-io