React Native报checkDebugAarMetadata错误，修改build.gradle无效如何解决？

解决方案 #

• 修正Android Gradle插件与SDK版本的匹配关系
  你当前使用的com.android.tools.build:gradle:4.1.0最高仅支持compileSdkVersion = 30，请先将根目录build.gradle的ext块参数统一调整为匹配版本：

ext {
    buildToolsVersion = "30.0.3"
    minSdkVersion = 21
    compileSdkVersion = 30
    targetSdkVersion = 30
    ndkVersion = "20.1.5948944"
}

同时务必检查app模块下的build.gradle，确认里面的compileSdk、targetSdk参数也同步修改为30，仅修改根目录配置不会生效。

• 调整依赖仓库拉取优先级
  jcenter服务已经停止维护，优先从谷歌官方仓库拉取依赖可避免拉取不到AAR包的问题，将allprojects块中的google()调整到仓库列表第一位：

allprojects {
    repositories {
        google() // 移到第一位
        mavenLocal()
        maven {
            url("$rootDir/../node_modules/react-native/android")
        }
        maven {
            url("$rootDir/../node_modules/jsc-android/dist")
        }
        jcenter()
        maven { url 'https://www.jitpack.io' }
    }
}

• 全量清理缓存后重新构建
  依次执行以下命令清理所有本地缓存，避免旧缓存导致修改不生效：

# 清理安卓构建缓存
cd android
./gradlew clean
cd ..
# 清理Node依赖缓存
rm -rf node_modules package-lock.json yarn.lock
npm install

• 可选升级方案
  如果你的项目第三方依赖强制要求compileSdkVersion = 31，可将Android Gradle插件升级到支持31的7.0.4版本，对应升级gradle-wrapper中的gradle版本到7.0.2即可。

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