如何修复Expo eas build时出现的Gradle未知构建失败错误

排查步骤 #

• 核对Gradle与Expo SDK版本：打开android/build.gradle，检查classpath 'com.android.tools.build:gradle'版本是否与当前Expo SDK匹配，参考Expo官方文档调整至推荐版本。
• 清理构建缓存：执行eas build --clear-cache清除远程构建缓存；若已 eject 项目，本地执行./gradlew clean清理Gradle缓存。
• 排查依赖冲突：通过./gradlew dependencies生成依赖树，查找版本冲突的依赖，使用exclude规则排除冲突项。
• 更新EAS CLI：执行npm install -g eas-cli将CLI升级至最新稳定版，确保兼容项目配置。
• 指定Android SDK版本：在eas.json的build配置中添加Android SDK版本声明，示例：

  "preview": {
    "distribution": "internal",
    "android": {
      "sdkVersion": 33
    }
  }
  

• 获取详细日志：添加--verbose参数构建，eas build --platform android --verbose，从详细输出中定位具体错误。

问题详情 #

运行eas build构建Android应用时持续触发错误：

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

当前eas.json配置：

{
  "cli": {
    "version": ">= 2.6.0"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {}
  },
  "submit": {
    "production": {}
  }
}

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