React Native Expo Android构建失败求助：执行eas build命令报错

问题详情 #

执行命令eas build -p android --profile preview后构建失败，报错信息：

× Build failed🤖 Android build failed:Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.

目标是生成Android APK，需解决此Gradle构建错误。

解决步骤 #

• 对齐本地与项目Gradle版本：查看项目android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl指定的Gradle版本，运行gradle --version确认本地安装版本，不一致则更新本地Gradle或调整配置文件版本。
• 清理缓存：
  • 执行npx expo prebuild --clean清除Expo预构建缓存
  • 进入项目android目录，运行./gradlew clean清理Gradle构建缓存
• 排查依赖冲突：查看Run gradlew阶段的日志，定位具体报错（如依赖无法解析、版本冲突），可通过npx expo doctor自动检测项目依赖问题并给出修复建议。
• 验证EAS配置：检查eas.json中preview配置的Android构建类型是否正确设置为apk，示例配置：

  {
    "build": {
      "preview": {
        "android": {
          "buildType": "apk"
        }
      }
    }
  }
  

• 更新依赖与Expo SDK：运行npx expo update升级到兼容的最新Expo SDK版本，再执行npm install或yarn install更新项目依赖。
• 检查Android SDK环境：通过Android Studio的SDK Manager确认项目所需的SDK Platform、Build Tools版本已安装，且环境变量ANDROID_HOME配置正确。

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