React Native安卓端启动报错Task :app:processDebugResources FAILED求助

问题场景 #

React Native应用iOS端运行正常，但安卓端启动时持续报错Task :app:processDebugResources FAILED。本地环境配置与其他可正常运行的设备一致，环境信息如下：

• OpenJDK version 11.0.20（Zulu11.66.15-CA）
• Node: v16.20.1
• Yarn: 1.22.19
• Gradle: Azul Zulu version 11.0.21
• Android SDK相关：
  • API Level 34、33 平台包
  • Build Tools 34.0.0、33.0.0、30.0.2
  • Google APIs Arm 64 v8a System Image

已尝试清理Gradle缓存及多数通用解决方案，问题仍未解决。

针对性排查方案 #

1. 检查Android SDK路径权限 #

• 确认本地Android SDK所在目录的读写权限，Windows系统默认路径为C:\Users\<你的用户名>\AppData\Local\Android\Sdk，Mac为~/Library/Android/sdk，确保当前用户拥有完全控制权限。
• 避免将SDK放在包含中文、空格或特殊字符的路径下，改用纯英文无空格路径。

2. 强制指定Gradle JDK版本 #

在项目根目录的android/gradle.properties中添加以下配置，强制Gradle使用指定的Zulu JDK 11：

org.gradle.java.home=/path/to/your/zulu11/jdk

替换/path/to/your/zulu11/jdk为本地Zulu11的实际安装路径，例如Mac下可能是/Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home，Windows下可能是C:\Program Files\Zulu\zulu-11。

3. 检查项目资源与配置冲突 #

• 打开android/app/src/main/res目录，排查是否存在重复命名的资源文件（如同名drawable、layout文件），尤其是不同分辨率目录下的重复资源。
• 检查AndroidManifest.xml中的权限声明、组件注册是否存在格式错误，比如标签未闭合、属性值非法。

4. 彻底清理并重建项目 #

执行以下命令完成全量清理与构建：

# 清理前端依赖缓存
rm -rf node_modules && yarn install
# 切换到安卓目录清理构建缓存
cd android && ./gradlew cleanBuildCache clean
# 重新构建debug包
./gradlew assembleDebug

Windows系统下将rm -rf替换为rd /s /q，./gradlew替换为gradlew.bat。

5. 统一Build Tools与SDK版本兼容性 #

在android/build.gradle中确保compileSdkVersion、targetSdkVersion与Build Tools版本匹配，示例配置如下：

buildscript {
    dependencies {
        classpath("com.android.tools.build:gradle:7.4.2") // 适配API33的稳定Gradle插件版本
    }
}

android {
    compileSdkVersion 33
    buildToolsVersion "33.0.2"

    defaultConfig {
        targetSdkVersion 33
    }
}

6. 修复本地Gradle缓存与配置 #

• 打开android/gradle/wrapper/gradle-wrapper.properties，确认distributionUrl指向的Gradle版本与其他正常设备一致，示例：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

• 手动删除本地Gradle缓存目录：Mac/Linux为~/.gradle/caches，Windows为C:\Users\<你的用户名>\.gradle\caches，删除后重新执行构建。

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