Expo开发构建失败：解析插件com.facebook.react.settings出错（React Native 0.76.9，SDK 52）

开发者阿泽

2026-4-13

嘿，我之前帮朋友排查过几乎一模一样的问题，给你几个实用的解决方向，亲测有效：

先检查settings.gradle的插件引用格式
打开你项目里的android/settings.gradle文件，找到报错的第4行。React Native 0.76.x版本已经调整了插件的引入规则，你可以把那行的插件引用改成带版本号的格式：
```
id("com.facebook.react.settings") version "0.76.9" apply false
```
注意版本号必须和你用的React Native版本完全一致，别写错数字哦。
清理Gradle缓存并同步配置
缓存是这类问题的常客，先在项目根目录执行这两个命令清缓存、刷新依赖：
```
./gradlew clean
./gradlew build --refresh-dependencies
```
如果用Android Studio开发的话，也可以直接点顶部菜单栏的「File」→「Sync Project with Gradle Files」，让IDE帮你同步配置。
重新生成原生配置文件
Expo SDK52的开发构建对原生配置的要求比较严格，旧的配置残留很容易出问题。你可以执行这个命令重新生成安卓原生文件（执行前记得备份安卓目录里你自己改的代码哦）：
```
npx expo prebuild --clean
```
确认Gradle插件和仓库配置
打开android/build.gradle文件，检查buildscript块里的仓库和依赖：
1. 仓库必须包含google()和mavenCentral()，确保能拉到插件；
2. 确认React Native Gradle插件的版本和你的RN版本匹配，比如：
```
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:8.7.0")
        classpath("com.facebook.react:react-native-gradle-plugin:0.76.9")
    }
}
```