React Native执行npx react-native run-android报checkDebugAarMetadata错误

核心问题梳理 #

你遇到的报错本质是三个版本不兼容+依赖源同步问题：

• JDK版本过高与当前React Native、Android构建工具链不兼容
• Android Gradle Plugin(AGP)版本与Gradle版本不匹配
• 旧版本Flipper依赖的Fresco组件未同步到mavenCentral

操作步骤 #

1. 替换JDK版本 #

卸载当前JDK16，安装JDK11，将系统环境变量JAVA_HOME指向JDK11的安装路径，重启终端生效。

2. 匹配AGP与Gradle版本 #

你当前使用的AGP 4.1.0最高仅支持Gradle 6.5，与你安装的Gradle7.1.1不兼容，二选一即可：

• 方案A：降级Gradle版本
  修改android/gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl字段，对应Gradle6.5版本即可
• 方案B：升级AGP版本
  修改android/build.gradle文件dependencies代码块中的classpath配置为com.android.tools.build:gradle:7.0.4，该版本与Gradle7.1.1适配

3. 修复Fresco依赖拉取失败问题 #

旧版本Flipper依赖的Fresco 2.2.0未同步到mavenCentral，修改android/gradle.properties文件中的FLIPPER_VERSION配置项为0.125.0，新版本Flipper依赖的组件均已同步到mavenCentral。

4. 清理缓存重新构建 #

依次执行以下命令：

• 删除项目根目录下的node_modules文件夹、package-lock.json文件
• 执行npm install重新安装依赖
• 进入android目录，执行./gradlew clean清理构建缓存
• 回到项目根目录，执行npx react-native run-android启动构建

内容的提问来源于stack exchange，提问作者Skull candy