避开雷区！一文理清App Store审核状态流转，加速应用上架

midmirrorsoul

2634人浏览 · 2025-05-08 16:23:28

midmirrorsoul · 2025-05-08 16:23:28 发布

摘要： 你是否也曾在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，此过程可能延长审核时间。