RN安卓执行yarn android构建报错Task :app:generateDebugBuildConfig FAILED

该报错本质是安卓构建阶段生成BuildConfig类时配置校验不通过导致的失败，你已经尝试过的项目级清理操作无效的情况下，通常是以下几类问题导致：

核心报错原因 #

• 配置类问题：applicationId存在非法字符、SDK版本配置不匹配、本地SDK路径配置错误
• 缓存类问题：全局gradle缓存损坏，仅清理项目级缓存无法修复
• 依赖类问题：第三方原生依赖的构建配置和主项目配置冲突

分步解决方案 #

第一步：校验android/app/build.gradle配置 #

打开android/app/build.gradle文件，检查以下配置项：

• defaultConfig下的applicationId只能包含大小写字母、数字和英文点，不能以数字或点开头/结尾，不能包含特殊字符、中文、空格
• compileSdkVersion、targetSdkVersion、buildToolsVersion三者版本匹配，且和你本地Android SDK Manager中安装的版本一致，比如compileSdkVersion 33对应buildToolsVersion "33.0.2"
• 所有依赖的原生模块的minSdkVersion不高于主项目设置的minSdkVersion，如果存在冲突，统一将主项目的minSdkVersion调整到和最高要求的依赖一致即可

第二步：清理全局gradle缓存 #

执行以下命令清除全局gradle缓存，项目级缓存清理无法解决全局缓存损坏的问题：
rm -rf ~/.gradle/caches/

第三步：检查本地配置文件 #

• 打开android/local.properties，确认sdk.dir配置的路径和你本地Android SDK的实际安装路径完全一致，路径中不能包含中文、空格、特殊字符
• 打开android/gradle.properties，确认org.gradle.jvmargs参数分配的内存足够，建议配置为：org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m

第四步：全量重置项目并重新构建 #

依次执行以下命令：

rm -rf node_modules
yarn install
cd android
./gradlew clean
cd ..
yarn android

以上步骤执行完成后90%以上的该类报错都可以解决。

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