React Native Android构建失败：依赖解析异常求助（原运行正常）

开发者阿泽

2026-8-13

React Native 构建失败（无法解析react-native依赖）解决方案

问题概述

此前运行正常的项目突然出现构建失败：

BUILD FAILED in 2s
error 应用安装失败。错误：命令执行失败：gradlew.bat app:installDebug -PreactNativeDevServerPort=8081
FAILURE: Build failed with an exception.
问题原因：根项目'Peace Garden'配置出现问题。

核心错误信息：

无法确定null的依赖项。无法解析配置':classpath'的所有任务依赖项。
无法解析com.facebook.react:react-native:+。被以下项目依赖：project :
未找到匹配的com.facebook.react:react-native:0.71.0-rc.0变体。消费者配置为寻找兼容Java 11的库运行时，以jar包形式打包，依赖项外部声明，且要求属性'org.gradle.plugin.api-version'的值为'7.3.3'

修复步骤

1. 锁定react-native稳定版本

打开项目根目录的package.json，将react-native的版本号从+替换为你之前使用的稳定版本（比如0.70.6）：

"dependencies": {
  "react-native": "0.70.6"
}

执行依赖安装：

npm install
# 或 yarn install

2. 同步Gradle配置与React Native版本

打开android/build.gradle，调整com.android.tools.build:gradle版本，确保和React Native版本匹配（例如0.70.x对应7.2.x）：
```
buildscript {
  dependencies {
    classpath("com.android.tools.build:gradle:7.2.3")
  }
}
```
打开gradle/wrapper/gradle-wrapper.properties，修改Gradle分发版本（0.70.x对应7.5）：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
```

3. 清理缓存并重新构建

# 清理npm/yarn缓存
npm cache clean --force
# 或 yarn cache clean

# 清理Android构建缓存
cd android
./gradlew clean
cd ..

# 重置Metro缓存并重新启动构建
npx react-native start --reset-cache
npx react-native run-android