症状：App Store Connect 构建一直显示 Processing。
最快解法：先在 TestFlight 页面的 Build Uploads 中核对状态和详情；Apple 说明，超过 24 小时仍处于 Processing，可能存在问题，应提交 Feedback Assistant 工单或联系支持。不要把重复上传当作默认解决方案。(Apple：构建上传状态及处理建议)
刚通过 Xcode 或 Transporter 上传构建、但状态没有变化的独立开发者，可以按本文区分等待与故障。
维护 TestFlight 发布流程的小团队，可以用下文的检查步骤复核上传记录。
负责远程 Mac 发布任务的人，也可以据此判断问题是在本地上传端，还是已进入 Apple 处理阶段。
先核对 Build Uploads，再判断 TestFlight 是否可见
Processing 不等于 Failed。Build Uploads 用来查看上传进度和错误详情；TestFlight 构建列表用于查看经过处理的构建。Apple 说明，上传的构建需要先经过系统处理，之后才会显示在 App Store Connect 中。(Apple：上传构建及处理流程)
| 状态或现象 | 能说明什么 | 下一步怎么做 |
|---|---|---|
| Processing | 上传仍在处理中；超过 24 小时可能存在问题 | 核对记录详情和上传时间；超过阈值后按 Apple 指引升级处理 |
| Failed | 上传已完成处理，但遇到了问题 | 打开记录查看错误、警告和信息，再决定是否修正后重新上传 |
| Complete | 上传处理成功，构建已准备好进行测试 | 到 TestFlight 构建列表核对应用、平台、版本和构建号 |
| TestFlight 暂时找不到构建 | 仅凭列表无法判定上传失败 | 检查上传记录和筛选项，再核对后续测试分发步骤 |
这里有两类不同状态：Build Uploads 中的 Complete 表示上传处理成功；TestFlight 中的构建状态可能描述构建是否可供测试、是否正在测试等后续情况。上传处理状态不等于 App Review 审核结果，也不等于 App Store 上架状态。(Apple：App 构建状态说明)
Processing 持续不变时，检查这条上传记录
在 App Store Connect 的 Apps 中选择对应应用，打开 TestFlight 页面，找到 Build Uploads 区域。查看状态和详情，不要只刷新构建列表。Apple 将 Processing 超过 24 小时列为可能存在问题的情形，并建议提交 Feedback Assistant 工单或联系支持；这不是对一般处理时长的承诺。(Apple：查看构建及上传状态)
逐项核对这次上传：
- 应用是否正确：确认当前页面对应的是这次上传的应用。
- 平台是否正确：检查查看的是 iOS 构建，而不是其他平台。
- 版本号与构建号是否匹配：从上传记录确认这次提交对应的版本和构建号。Apple 使用应用包中的 bundle ID 和版本号关联应用及版本记录，并用构建字符串识别构建。(Apple：上传构建的关联方式)
- 上传时间是否记对：以本次上传记录为准，不要把开始归档的时间当成上传时间。
- 详情中有没有可用信息：状态没有变化，也应查看详情里的错误、警告或其他信息。
| 核对项 | 去哪里确认 | 为什么不能略过 |
|---|---|---|
| 应用与平台 | 当前应用页面及 TestFlight 平台选择 | 看错应用或平台，容易把“没找到”误判成上传失败 |
| 版本与构建号 | Build Uploads 记录及构建详情 | 用于区分本次上传与更早或重复提交的构建 |
| 状态及详情 | Build Uploads 状态和相关说明 | Processing、Failed、Complete 对应不同处理方向 |
| 上传时间与本地结果 | 上传工具的交付记录或日志 | 帮助判断本地上传是否结束、Apple 是否已生成记录 |
Failed 时先读错误，再决定是否重新上传
Apple 对 Failed 的说明是：上传已完成处理，但遇到了问题。打开对应记录，查看关联的错误、警告和信息，再按详情判断是否需要修正项目并重新上传。若上传失败，Apple 说明可以在下一次上传时复用相同构建号；先解决记录中的错误，再提交构建。(Apple：构建上传状态及失败处理)
如果 Xcode 归档未成功、上传仍在进行，或上传工具报告交付失败，那就不能仅凭这些现象认定 Apple 端处理失败。先查本地操作结果和日志。Xcode 的分发流程包含归档和上传步骤；只有确认本地上传操作已结束，才适合继续核对 App Store Connect 中对应的上传记录。(Apple：通过 Xcode 分发 App)
| 观察到的证据 | 优先检查位置 | 处理方向 |
|---|---|---|
| Xcode 或 Transporter 未报告上传完成 | 本地归档、打包或传输流程 | 查看工具显示的错误与交付记录，确认是否已提交完成 |
| Build Uploads 已出现 Processing | 上传记录及 Apple 处理阶段 | 核对详情；超过官方提示阈值后升级处理 |
| Build Uploads 显示 Failed | 对应上传记录 | 查看错误、警告和信息，再决定是否修正后重传 |
| Build Uploads 显示 Complete，但列表找不到 | 应用、平台、版本及列表筛选 | 核对构建记录和测试分发状态，不先推断上传失败 |
这些证据能帮助划分排查方向，却不能单独证明具体根因。不要仅凭状态猜测是证书、网络、构建文件或服务端故障；以对应上传记录和本地日志为准。
Complete 但 TestFlight 不可见时，检查版本和分发步骤
若上传记录显示 Complete，先确认打开的是正确应用，再选择正确平台、展开对应版本并核对构建号。Apple 的构建查看说明指出，构建按版本组织；展开版本后，才能查看对应的构建记录和详情。(Apple：查看构建版本和元数据)
还要把“上传处理完成”和“开始测试”分开检查。构建处理成功后，是否已加入测试组、能否开始内部或外部测试，属于后续分发流程。Apple 的 TestFlight 说明中，内部测试需要将测试员添加到测试组；构建已处理并不意味着已完成这些分发设置。(Apple：添加 TestFlight 内部测试员)
按这个顺序复核：
- 确认应用记录和平台。
- 展开正确的版本，查找本次构建号。
- 打开构建详情，确认上传处理状态。
- 检查测试组和后续分发步骤，不要把缺少测试入口当成上传失败。
- 如果上传记录与列表仍对不上，保存记录信息，再联系支持核实。
App Store Connect 的发布工作流将 TestFlight 测试和提交 App Review 作为不同环节。因此，构建处理完成、测试分发和面向用户上架，不能混为一谈。(Apple：App Store Connect 工作流)
按步骤判断该等待、修正还是升级处理
第一步：确认本地上传是否结束
查看 Xcode、Transporter 或实际使用的上传流程，确认它是否报告本次上传完成。Xcode Organizer 可用于查看分发进度；如果使用 Transporter，也应查看其交付记录和日志。若本地没有明确的完成证据，先查本地上传日志，暂时不要把问题归到 Apple 处理阶段。
第二步：找到匹配的 Build Uploads 记录
到对应应用的 TestFlight 页面，确认是否存在与本次提交匹配的记录。核对平台、版本号、构建号和上传时间。没有匹配记录时，先回查本地上传结果和选中的应用；仅凭 TestFlight 构建列表暂时为空，不能断定上传失败。
第三步：按状态采取动作
- Processing，未超过官方提示阈值：记录当前状态，继续查看对应上传记录。不要把 24 小时理解为正常处理时长或必然完成期限。
- Processing 超过 24 小时：按 Apple 建议提交 Feedback Assistant 工单或联系支持。
- Failed：查看记录详情中的错误、警告和信息，解决明确指出的问题后再考虑重传。
- Complete 但 TestFlight 不可见：核对应用、平台、版本、构建号和测试分发步骤。
第四步：整理支持工单需要的证据
提交问题前，准备应用标识或名称、平台、版本号、构建号、上传日期与时间，以及对应的 Build Uploads 状态和详情。若本地上传流程有错误信息或交付日志，也一并保存。
不要只写“卡住了”。应说明本地工具是否报告完成、App Store Connect 是否生成了上传记录，以及该记录目前显示什么状态。可以用下面的模板整理；命令只用于生成当前 UTC 时间，方括号内容需替换为实际信息。
date -u '+%Y-%m-%dT%H:%M:%SZ'
应用：[应用名称或标识]
平台：[平台]
版本号：[版本号]
构建号：[构建号]
上传时间：[日期与时间及所在时区]
本地上传结果：[完成 / 未完成 / 有错误]
Build Uploads 状态：[Processing / Failed / Complete]
详情与日志：[填写实际错误信息或日志]
第五步：提交后继续跟踪原记录
Processing 超过 24 小时仍未更新时，按 Apple 的建议提交 Feedback Assistant 工单或联系支持。提交后继续核对原上传记录，并单独记录后续构建号；不要因为新提交了构建，就把先前卡住的记录视为已解决。
常见问题
Processing 多久算异常？
不要把 Processing 当成倒计时。Apple 说明，超过 24 小时仍显示 Processing，可能存在问题；这时应提交 Feedback Assistant 工单或联系支持。该阈值不是对其他上传的处理速度保证，也不能用来推断具体故障原因。先确认记录属于正确应用和构建，再升级处理。
Failed 后如何查看原因？
在 Build Uploads 中选中 Failed 的上传记录，查看错误、警告和信息。再把详情与本地归档及上传工具的结果对照，判断问题是在本地流程还是进入上传处理后出现。按详情修正明确的问题，再决定是否重新上传；不要只凭 Failed 标签猜测根因。
Processing 但 TestFlight 看不到怎么办？
回到 Build Uploads 核对状态，再检查应用、平台、版本和构建号。Apple 说明，上传构建需要先处理，之后才会显示在 App Store Connect 中；因此 TestFlight 列表暂时没有构建，不能单独证明上传失败。若记录已是 Complete，再检查后续测试分发步骤；若仍在 Processing，则按该状态排查。
超过 24 小时仍在处理，该联系谁？
先确认 Build Uploads 中对应记录仍处于 Processing，并整理应用、平台、版本号、构建号、上传时间与相关日志。按 Apple 的建议提交 Feedback Assistant 工单或联系支持。提供能对应到具体上传记录的信息，并保留后续构建记录，避免把新提交误当作旧记录已恢复。
让发布环境和问题证据都可追溯
这类问题的关键不是尽快多传几次，而是分清本地上传是否完成、Apple 是否已生成对应处理记录，以及 TestFlight 是否只是尚未显示或尚未完成后续分发。若发布流程依赖持续运行的 Mac，可先了解 NUMACS 远程 Mac 的开始使用说明，并在需要排查使用问题时查看 NUMACS 帮助中心。
如果问题确实发生在持续运行的打包环境，再比较本地 Mac、其他构建方式和远程 Mac：本地设备需要自行维护，临时环境不一定持续在线，远程任务则需要稳定的访问和日志交接。对短期发布、临时测试或需要补足 Mac 环境的团队，租赁 NUMACS 的 Mac 可以作为可评估的选择；若是长期稳定的重负载任务，或必须直接连接物理设备，则应先评估自购设备是否更合适。需要比较时，可查看 NUMACS 的方案信息。
常见问题
App Store Connect 构建 Processing 多久需要升级处理？
Apple 将上传后仍处于 Processing 超过 24 小时列为可能存在问题的情况，并建议提交 Feedback Assistant 工单或联系支持。这个阈值不是常规处理时长承诺。尚未超过阈值时，先检查 Build Uploads 记录和详情；超过后，再附上应用、平台、版本、构建号、上传时间及相关日志提交。
构建已经 Complete，为什么 TestFlight 里还是找不到？
先确认选中的应用、平台和版本正确，并展开对应版本检查构建号。Build Uploads 的 Complete 表示上传处理成功，不代表测试分组、测试员邀请或后续审核步骤已经完成。若上传记录已完成但列表仍不匹配，应保存记录详情并检查测试分发状态，而不是仅凭列表缺项再次上传。
App Store Connect 显示 Failed 后，应该先做什么？
打开失败的上传记录，查看关联的错误、警告和信息，再判断是否需要修改构建并重新上传。Failed 表示上传已完成处理但遇到问题；它不同于本地归档或传输尚未完成。先按详情修正明确指出的问题，不要只看状态标签猜测证书、网络或二进制文件是根因。
上传超过 24 小时仍在处理，联系 Apple 时要准备哪些信息？
先确认对应上传记录仍显示 Processing，再准备应用名称或标识、平台、版本号、构建号、上传日期与时间，以及 Xcode 或 Transporter 的相关日志。按 Apple 的建议提交 Feedback Assistant 工单或联系支持。记录工单后继续核对后续构建，避免把重复上传误当成原记录已解决。
NUMACS 云端 Mac
为下一次构建准备好远程 Mac
NUMACS 提供独享 Apple Silicon 物理 Mac，可通过远程桌面或 SSH 运行 iOS 与 macOS 构建任务。