React Native Expo裸工程构建失败：依赖与Java版本兼容问题

错误核心原因 #

1. Android Gradle Plugin（AGP）版本不兼容
   系统尝试拉取com.android.tools.build:gradle:8.4，但该版本与当前使用的Gradle 8.4不匹配——AGP 8.4要求Gradle 8.6及以上版本，导致仓库中无法找到对应资源。
2. Java版本与插件要求不匹配
   com.facebook.react:react-native-gradle-plugin需要Java 11及以上运行环境，但当前系统使用Java 8，同时插件变体无法满足Gradle插件API版本8.4的要求，直接导致依赖解析失败。

分步解决方案 #

1. 升级Java版本至17（推荐）或11 #

React Native 0.71+及AGP 8.0+均要求Java 11以上，AGP 8.0+更推荐Java 17。安装对应版本后，确保系统JAVA_HOME环境变量指向新Java路径，终端执行java -version确认版本生效。

2. 调整AGP版本与Gradle匹配 #

打开项目根目录下的android/build.gradle文件，修改dependencies中的AGP版本为与Gradle 8.4兼容的版本（如8.1.4）：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:8.1.4'
        // 保留其他原有依赖
    }
}

3. 对齐React Native Gradle插件版本 #

同样在android/build.gradle中，确保react-native-gradle-plugin版本与项目使用的React Native版本一致（例如RN 0.72.x对应插件版本0.72.x）：

buildscript {
    dependencies {
        classpath 'com.facebook.react:react-native-gradle-plugin:0.72.6'
        // 保留其他原有依赖
    }
}

4. 清理缓存并重新构建 #

执行以下命令清理旧缓存，重新触发构建：

./gradlew clean
./gradlew assembleDebug

或使用npm命令：

npm run android

额外检查：确认仓库配置 #

在android/build.gradle中确保已配置Google Maven仓库，避免依赖查找失败：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    // 其他配置...
}

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