React Native安卓构建失败：':react-native-community_checkbox:generateDebugRFile'任务报错

问题背景 #

开发3个月的React Native项目，运行安卓端时构建失败，核心错误如下：

核心错误信息 #

error Failed to install the app. Make sure you have the Android development environment set up: https://reactnative.dev/docs/environment-setup.

Error: 命令执行失败: ./gradlew app:installDebug -PreactNativeDevServerPort=8081

具体构建失败项 #

1. 任务:react-native-community_checkbox:generateDebugRFile执行失败

无法解析':react-native-community_checkbox:debugCompileClasspath'的所有文件。
无法转换react-native-0.71.0-rc.0-debug.aar (com.facebook.react:react-native:0.71.0-rc.0)以匹配属性要求。
找不到react-native-0.71.0-rc.0-debug.aar (com.facebook.react:react-native:0.71.0-rc.0)，已在以下位置搜索：
https://repo.maven.apache.org/maven2/com/facebook/react/react-native/0.71.0-rc.0/react-native-0.71.0-rc.0-debug.aar

2. 任务执行异常：java.lang.StackOverflowError（无错误消息）

完整错误栈 #

at makeError (/Users/arslantek/Desktop/TTDeneme23Ocak/TTMedMobil/node_modules/execa/index.js:174:9)
at /Users/arslantek/Desktop/TTDeneme23Ocak/TTMedMobil/node_modules/execa/index.js:278:16
at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
at async runOnAllDevices (/Users/arslantek/Desktop/TTDeneme23Ocak/TTMedMobil/node_modules/@react-native-community/cli-platform-android/build/commands/runAndroid/runOnAllDevices.js:109:5)
at async Command.handleAction (/Users/arslantek/Desktop/TTDeneme23Ocak/TTMedMobil/node_modules/@react-native-community/cli/build/index.js:142:9)

解决方案 #

针对这两个问题，按以下步骤逐一处理：

1. 解决找不到react-native-0.71.0-rc.0-debug.aar的问题 #

• 问题原因：RC版本（候选发布版）的debug AAR包通常不会上传到Maven中央仓库，只有正式版才会发布到公共仓库。
• 修复步骤：
  • 检查项目中react-native-community/checkbox依赖的版本，确认是否与当前RN主版本匹配。如果你的RN主版本不是0.71.0-rc.0，需要调整checkbox依赖版本，或者升级/降级RN到稳定正式版。
  • 若坚持使用RN 0.71.0-rc.0，需在项目的android/build.gradle中添加Facebook的Maven仓库（RC版本会发布到这里）：

    repositories {
        // 其他仓库...
        maven { url 'https://maven.facebook.com' }
    }
    

  • 清理本地缓存：执行./gradlew clean，然后删除项目根目录的node_modules和package-lock.json/yarn.lock，重新执行npm install或yarn install。

2. 解决java.lang.StackOverflowError问题 #

• 问题原因：Gradle构建时堆内存不足，或依赖树过深导致栈溢出。
• 修复步骤：
  • 修改android/gradle.properties文件，增加JVM堆内存配置：

    org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=1024m
    

  • 检查项目依赖是否存在循环依赖或重复依赖，使用./gradlew app:dependencies查看依赖树，排除重复或不必要的依赖。
  • 更新Gradle版本到稳定版，确保使用的Gradle插件与RN版本兼容。

验证步骤 #

完成上述修复后，重新执行npx react-native run-android，观察构建是否成功。

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