Expo-EAS构建Android APK失败求助（Windows 11环境）

1. 校验eas.json的Android预览配置 #

确保preview环境的Android配置无语法或逻辑错误，示例正确配置片段：

{
  "build": {
    "preview": {
      "android": {
        "buildType": "apk",
        "gradleCommand": ":app:assembleRelease"
      },
      "ios": {
        "simulator": false
      }
    }
  }
}

重点确认：

• buildType设置为apk（适合外部设备测试）
• 无多余的Gradle参数或无效环境变量配置

2. 检查依赖兼容性 #

• 执行expo doctor命令，检测所有依赖与当前Expo SDK版本的匹配度，修复提示的冲突项
• 确保react-native版本与Expo SDK绑定的版本完全一致（Expo SDK对应固定RN版本，禁止手动修改）
• 移除已废弃的Android专属原生模块，替换为Expo官方支持的替代方案

3. 提取Gradle错误核心信息 #

从EAS构建日志的Run gradlew步骤中定位具体错误栈，常见故障类型：

• 网络问题导致Gradle依赖无法下载（可在eas.json中配置国内镜像源）
• AndroidManifest.xml权限配置冲突（Expo自动生成配置与自定义配置冲突）
• 原生模块编译错误（部分模块需要特定NDK或Gradle插件版本）

4. 针对性修复步骤 #

• 清理EAS远程构建缓存：执行eas build --platform android --profile preview --clear-cache（注意是EAS云端缓存，而非本地node_modules）
• 检查Windows环境变量：确认ANDROID_HOME路径正确，避免与Expo自动管理的Android环境冲突
• 更换构建节点：在EAS构建控制台切换到其他区域节点，规避节点网络故障

5. Windows环境特殊检查 #

• 确保系统字符编码为UTF-8（此前iOS的编码问题同样可能影响Android构建）
• 手动删除C:\Users\<你的用户名>\.gradle目录，重建Gradle本地缓存后重新触发构建

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