故障排查

连接失败

先核对凭证类型、ID 是否属于同一账号上下文、私钥格式和本机时间。网络代理启用时，还要确认代理地址、TLS 根证书和 DNS。

能读取但不能写入

读取应用成功只证明凭证有效。检查目标应用权限、Provider 角色、协议状态和操作所需的具体资源权限，不要通过扩大到全局管理员来掩盖权限模型问题。

预检失败

以包内 Info.plist、manifest、签名和 Profile 为准。文件名、构建脚本输出名和手工记录不能替代包体事实。

上传失败

按任务阶段区分预约、分片、checksum、确认和平台处理。保留公开错误码与字段路径；不要在聊天或工单中发送 Authorization、Cookie、完整 Key 或私钥。

平台处理时间过长

先刷新远端 Build/包体状态，确认是否仍在处理或已经失败。不要因为界面短时间没有变化就重复上传相同版本。

仍无法定位

准备 Provider、应用、包体版本、任务 ID、发生时间、最后成功阶段和脱敏日志。完整上下文比“上传报错”四个字更容易得到准确答案。