摘要： 你是否也曾在App Store审核中反复踩坑？构建包总显示“INVALID”却找不到原因？版本卡在“IN_REVIEW”迟迟无进展？本文深度解析 App Store Connect API 中构建包（Build）与提审版本（Version）的18个关键状态，附 完整状态流转图 + 开发者避坑指南，助你告别无效等待，效率提升50%！
适合读者： iOS开发者、应用发布负责人、App运营人员 阅读收获： 掌握审核生命周期，预判风险节点，让应用上架少走弯路！
一、Build 构建的状态有哪些
该字段表示构建包（Build）在苹果服务器上的处理状态，直接影响能否提交到 App Store 版本。
1. PROCESSING
含义：构建包已上传，苹果服务器正在处理（如签名验证、符号文件生成、加密检查等）。流转：
初始状态为 PROCESSING（上传成功后立即进入）。可能转为 VALID（处理成功）、FAILED（处理失败）或 INVALID（验证失败）。
2. FAILED
含义：处理过程中发生技术性错误（如网络中断、文件损坏）。处理：需重新上传构建包，状态重置为 PROCESSING。
3. INVALID
含义：构建包未通过苹果验证（如签名错误、缺少权限、架构不兼容）。处理：修复问题后重新上传，状态转为 PROCESSING。
4. VALID
含义：构建包已通过验证，可关联到 App Store 版本或 TestFlight 测试。流转：
若长时间未使用（如 30 天未关联版本），可能过期变为 EXPIRED（但此状态不在当前字段枚举中，可能属于其他字段）。
二、Version 版本的状态有哪些
该字段表示 App Store 提审版本的生命周期状态，涵盖从准备提交到上架或拒绝的全流程。
1. PREPARE_FOR_SUBMISSION
含义：版本已创建但未提交，开发者正在配置元数据（描述、截图）或关联构建包。流转：关联 VALID 构建包后，可转为 READY_FOR_REVIEW（提交准备完成）。
2. READY_FOR_REVIEW
含义：版本已满足提交条件（元数据完整、构建包有效），等待开发者确认提交。流转：提交后进入 WAITING_FOR_REVIEW。
3. WAITING_FOR_REVIEW
含义：版本已提交，排队等待苹果审核。流转：可能转为 IN_REVIEW（开始审核）或 DEVELOPER_REJECTED（开发者主动撤回）。
4. IN_REVIEW
含义：苹果审核团队正在审核版本。流转：
审核通过：转为 ACCEPTED（自动发布）或 PENDING_DEVELOPER_RELEASE（需手动发布）。审核拒绝：转为 REJECTED（完全拒绝）、METADATA_REJECTED（仅元数据问题）或 INVALID_BINARY（构建包问题）。
5. ACCEPTED
含义：版本已通过审核并自动进入发布流程（适用于设置为自动发布的应用）。流转：随后进入 PROCESSING_FOR_DISTRIBUTION（苹果处理发布）或直接上架。
6. PENDING_DEVELOPER_RELEASE
含义：版本已通过审核，等待开发者手动发布（适用于手动发布设置的应用）。流转：开发者手动发布后转为 READY_FOR_SALE（已上架）。
7. PROCESSING_FOR_DISTRIBUTION
含义：苹果正在处理版本发布（如生成加密密钥、分发到全球 CDN）。流转：完成后转为 READY_FOR_SALE。
8. READY_FOR_SALE
含义：版本已成功上架 App Store，用户可下载。
9. REJECTED
含义：版本因严重问题被拒绝（如功能违规、崩溃）。处理：修复后需重新提交，状态重置为 PREPARE_FOR_SUBMISSION。
10. METADATA_REJECTED
含义：元数据被拒（如截图不符、描述含违规词），但构建包有效。处理：修改元数据后重新提交，无需重新上传构建包。
11. INVALID_BINARY
含义：构建包在审核过程中被发现存在问题（如隐藏功能、使用私有 API）。处理：修复后需上传新构建包并重新提交。
12. DEVELOPER_REJECTED
含义：开发者主动撤回已提交的版本。流转：可重新编辑后再次提交。
13. WAITING_FOR_EXPORT_COMPLIANCE
含义：版本需等待出口合规验证（如加密技术合规审查）。流转：合规验证通过后进入 WAITING_FOR_REVIEW。
14. REPLACED_WITH_NEW_VERSION
含义：当前版本被更高版本号的提交取代（如已提交 1.1.0 后，1.0.0 版本状态变为此）。
三、典型状态流转示例
成功上架流程
上传构建包 → PROCESSING → VALID。创建版本 → PREPARE_FOR_SUBMISSION → 关联构建包 → READY_FOR_REVIEW。提交审核 → WAITING_FOR_REVIEW → IN_REVIEW → ACCEPTED → PROCESSING_FOR_DISTRIBUTION → READY_FOR_SALE。
被拒后修复流程
审核中 → REJECTED。修复问题，上传新构建包 → PROCESSING → VALID。重新提交版本 → PREPARE_FOR_SUBMISSION → 再次进入审核流程。
四、关键注意事项
构建包状态依赖：提交版本前，必须关联 VALID 的构建包。自动 vs 手动发布：若应用设置为手动发布，审核通过后进入 PENDING_DEVELOPER_RELEASE；自动发布则直接进入 ACCEPTED。出口合规：涉及加密功能的应用可能需等待 WAITING_FOR_EXPORT_COMPLIANCE，此过程可能延长审核时间。
五、参考来源
tds-Shiply | 腾讯端服务旗下面向端的全场景一站式发布平台
Build.Attributes | Apple Developer Documentation
AppVersionState | Apple Developer Documentation