React Native打包APK失败：react-native-gesture-handler错误排查

一、依赖缺失：找不到react-native-0.71.0-rc.0-release.aar #

• 核心原因：RN的RC候选版本大概率没同步到Maven中央仓库，本地Gradle缓存损坏，或者react-native-gesture-handler版本和RN版本不兼容。
• 解决操作：
  1. 打开项目根目录的package.json，确认RN版本是否真的是0.71.0-rc.0。如果是误装了RC版，直接切换到同分支的稳定正式版（比如0.71.12）——RC版本身就存在仓库同步不全、稳定性差的问题，不建议用于打包发布。
  2. 清理Gradle缓存：在Android项目根目录执行./gradlew clean，然后删除本地Gradle缓存目录（Mac/Linux是~/.gradle/caches，Windows是C:\Users\<你的用户名>\.gradle\caches），重新执行打包命令。
  3. 匹配react-native-gesture-handler版本：在package.json里把该库版本调整为RN 0.71.x兼容的版本（比如2.9.0），然后执行npm install或yarn install重新安装依赖。
  4. 检查Android仓库配置：打开Android项目的build.gradle（项目级），确保仓库配置包含以下内容：

     repositories {
         mavenCentral()
         google()
         maven { url "$rootDir/../node_modules/react-native/android" }
         maven { url "$rootDir/../node_modules/jsc-android/dist" }
     }
     

二、java.lang.StackOverflowError报错 #

• 核心原因：Gradle编译时JVM内存不足，或者依赖树过深导致递归调用栈溢出。
• 解决操作：
  1. 调整Gradle JVM参数：在项目根目录的gradle.properties文件中添加或修改：

     org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
     

     把堆内存（Xmx）调到4G以上，具体数值根据自己电脑的内存配置调整。
  2. 简化依赖树：执行./gradlew dependencies查看完整依赖关系，排查是否有重复依赖的库。如果有，在build.gradle（模块级）中用exclude排除重复项，比如：

     implementation('com.example:some-library') {
         exclude group: 'com.facebook.react', module: 'react-native'
     }
     

三、变量未声明、属性重复设置的警告 #

• 核心原因：第三方库的Android代码不规范，或者项目资源文件（如strings.xml、styles.xml）存在重复定义，或是RN版本升级后旧配置未适配。
• 解决操作：
  1. 检查资源文件：打开Android项目res目录下的values文件夹，查看strings.xml、styles.xml等文件，删除重复的标签或属性。
  2. 更新第三方库：根据警告信息定位到对应的库，去npm仓库查看该库是否有更新版本，升级到最新版修复代码不规范问题。
  3. 适配RN版本：如果是RN自身的警告，对照RN官方的版本升级指南，检查AndroidManifest.xml、build.gradle等配置项是否完成了全部适配。

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