故障排查

連線失敗

先核對憑證類型、ID 是否屬於同一帳號上下文、私鑰格式和本機時間。網路代理啓用時，還要確認代理地址、TLS 根證書和 DNS。

能讀取但不能寫入

讀取應用成功只證明憑證有效。檢查目標應用權限、Provider 角色、協議狀態和操作所需的具體資源權限，不要通過擴大到全局管理員來掩蓋權限模型問題。

預檢失敗

以包內 Info.plist、manifest、簽名和 Profile 為準。檔案名、構建腳本輸出名和手工記錄不能替代套件事實。

上傳失敗

按任務階段區分預約、分片、checksum、確認和平台處理。保留公開錯誤碼與字段路徑；不要在聊天或工單中傳送 Authorization、Cookie、完整 Key 或私鑰。

平台處理時間過長

先刷新遠端 Build/套件狀態，確認是否仍在處理或已經失敗。不要因為介面短時間沒有變化就重複上傳相同版本。

仍無法定位

準備 Provider、應用、套件版本、任務 ID、發生時間、最後成功階段和脫敏記錄。完整上下文比“上傳報錯”四個字更容易得到準確答案。