核心排查与修复步骤 #

1. 彻底确认Gradle版本切换到位

   • 检查android/gradle/wrapper/gradle-wrapper.properties，确保distributionUrl指向Gradle 7.6：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-all.zip
     

   • 核对android/build.gradle中的Gradle插件版本，React Native 0.76.x对应插件版本应为7.4.2，避免残留高版本配置：

     dependencies {
         classpath("com.android.tools.build:gradle:7.4.2")
         // 其他依赖配置...
     }
     

2. 排查第三方依赖的过时Gradle特性

   • 执行./gradlew android:dependencies生成依赖树，逐一检查第三方库是否使用了Gradle 9已废弃的语法（如compile配置、过时DSL方法）：
     • 对存在问题的库，优先升级到兼容Gradle 7.x的版本；无新版本则考虑替换为替代库。
   • 清理android/app/build.gradle中的废弃配置，比如移除android.enableR8=false这类已被移除的开关，替换为当前Gradle支持的写法。

3. 适配Expo SDK 52的构建逻辑

   • Expo SDK 52默认适配Gradle 8.x，强制切换到7.6可能引发隐藏冲突，先执行npx expo prebuild --clean重新生成原生代码，覆盖混乱配置。
   • 检查eas.json中的构建配置，确保没有指定会覆盖本地Gradle设置的参数：

     "build": {
       "development": {
         "android": {
           "gradleCommand": ":app:assembleDebug",
           "buildType": "development"
         }
       }
     }
     

4. 本地预验证构建

   • 先在本地运行./gradlew assembleDebug测试构建，能更快定位具体错误日志（比如哪个文件、哪行代码使用了废弃特性），比远程EAS Build日志更直观，再针对性修改原生Gradle脚本。

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