使用Xcode Cloud创建发布构建时遇“Preparing build for App Store Connect failed”错误

核心矛盾 #

本地构建、归档全正常，测试无问题，但Xcode Cloud在提交到App Store Connect环节失败，且无详细错误日志，大概率是Xcode Cloud环境与本地环境的配置差异，或是App Store Connect侧的权限/状态问题。

具体排查步骤 #

1. 核对账号权限与会话状态 #

• 确认Xcode Cloud关联的Apple ID拥有App Store Connect管理员或开发者权限，且已加入对应App的开发团队
• 检查账号双重认证状态：若近期修改过密码或MFA设置，可能导致Xcode Cloud的认证会话失效，重新在Xcode的Settings > Accounts中登录该账号，刷新证书与会话

2. 对齐本地与云端的Xcode及项目配置 #

• 匹配Xcode版本：在Xcode Cloud构建计划中，确认使用的Xcode版本和本地完全一致（比如都是15.0.1），版本差异可能导致隐性兼容性问题
• 检查签名配置：对比本地Signing & Capabilities与云端构建计划的签名设置，避免本地手动配置但云端自动签名出现冲突，确保证书、描述文件在云端可用
• 验证版本号/Build号：确保云端构建的版本号未在App Store Connect中存在过，且Build号大于所有已提交的历史版本

3. 检查App Store Connect侧的App状态 #

• 确认App处于可接受构建的状态：无"被拒绝""待补充信息"等锁定状态
• 核查协议与付款信息：登录App Store Connect，查看"协议、税务和银行业务"板块，确保所有必要协议已签署，付款信息有效

4. 强制刷新云端配置 #

• 重新同步构建计划：进入项目Product > Xcode Cloud > Manage Workflows，编辑对应计划后保存，触发新的构建
• 重新获取证书：在Xcode的Settings > Accounts中，选中对应Apple ID，点击Manage Certificates，下载或重新生成证书、描述文件

5. 深挖日志细节 #

• 解压下载的日志包，搜索关键词：error、failed、ITMS-、App Store Connect，错误信息可能隐藏在日志末尾或某个子环节中
• 尝试创建极简构建计划：去掉自定义脚本、第三方依赖等非必要配置，仅保留基础发布流程，排查是否是额外流程导致的问题

6. 排除第三方依赖与脚本干扰 #

• 临时注释项目中的post-build脚本（比如符号表上传、plist修改脚本），重新构建，排查是否是脚本在云端因权限、路径问题失败
• 确认依赖版本一致性：检查Podfile.lock或Package.resolved是否已提交到仓库，避免云端拉取和本地不一致的依赖版本

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