Expo iOS生产环境构建在Run fastlane阶段因未知错误失败

问题背景 #

• 预构建、开发环境构建均正常完成
• 执行命令 npx eas build --profile production --platform ios 时构建因未知错误失败
• 使用Expo 46+版本，eas.json配置如下：

{
  "cli": {
    "version": ">= 3.14.0"
  },
  "build": {
    "development-simulator": {
      "extends": "development",
      "ios": {
        "simulator": true
      }
    },
    "development": {
      "distribution": "internal",
      "developmentClient": true
    },
    "preview": {
      "distribution": "internal",
      "ios": {
        "simulator": true
      }
    },
    "production": {}
  },
  "submit": {
    "production": {}
  }
}

排查与解决步骤 #

1. 补全production构建核心配置 #

当前production配置为空，Test Flight发布需要明确指定分发类型为store，建议补充配置：

"production": {
  "distribution": "store",
  "ios": {
    "resourceClass": "m-medium" // 可选，避免构建资源不足导致失败
  }
}

2. 验证Apple开发者凭证有效性 #

• 执行 eas credentials 检查iOS证书、Provisioning Profile状态，生产环境必须使用App Store分发类型的Provisioning Profile
• 确认Apple开发者账号已激活开发者计划，拥有Test Flight发布权限

3. 清理本地构建缓存 #

本地缓存冲突可能导致生产构建异常，执行以下命令后重新构建：

npx expo prebuild --clean
rm -rf node_modules && npm install
npx eas build --clean --profile production --platform ios

4. 调整EAS CLI版本适配Expo 46 #

Expo 46与高版本EAS CLI可能存在兼容性问题，修改eas.json的cli版本限制：

"cli": {
  "version": "~3.8.0"
}

然后安装指定版本CLI：npm install -g eas-cli@3.8.0

5. 查看完整构建日志定位错误 #

登录EAS Dashboard找到对应构建记录，查看完整日志，通常能定位具体错误（如证书过期、依赖缺失、权限配置错误等）

内容的提问来源于stack exchange，提问作者Thoth-seshat