處理 Apple 平台上 Cloud Storage 的錯誤

有時建構應用程式時，事情可能不如預期，發生錯誤。

如有疑問，請檢查傳回的錯誤，並查看錯誤訊息內容。

如果檢查錯誤訊息後，您Cloud Storage Security Rules允許執行動作，但仍無法修正錯誤，請前往支援頁面，告訴我們如何提供協助。

處理錯誤訊息

發生錯誤的原因有很多，包括檔案不存在、使用者沒有存取所需檔案的權限，或是使用者取消上傳檔案。

如要正確診斷問題並處理錯誤，請參閱下列完整清單，瞭解用戶端會引發的所有錯誤，以及這些錯誤的發生方式。

名稱	原因
FIRStorageErrorCodeUnknown	發生不明錯誤。
FIRStorageErrorCodeObjectNotFound	指定參照位置沒有物件。
FIRStorageErrorCodeBucketNotFound	尚未為 Cloud Storage 設定 bucket。
FIRStorageErrorCodeProjectNotFound	Cloud Storage 未設定任何專案。
FIRStorageErrorCodeQuotaExceeded	您已超過 Cloud Storage bucket 的配額。如果採用 Spark 定價方案，建議升級至即付即用 Blaze 定價方案。如果已採用 Blaze 定價方案，請與 Firebase 支援團隊聯絡。 重要事項：最快自 2026 年 2 月 2 日起，使用 Cloud Storage (包括預設 bucket) 時必須採用 Blaze 定價方案。
FIRStorageErrorCodeUnauthenticated	使用者未通過驗證。請驗證身分，然後再試一次。
FIRStorageErrorCodeUnauthorized	使用者沒有執行要求動作的權限。檢查規則是否正確。
FIRStorageErrorCodeRetryLimitExceeded	作業 (上傳、下載、刪除等) 超過時間上限。請再次上傳。
FIRStorageErrorCodeNonMatchingChecksum	用戶端上的檔案與伺服器收到的檔案總和檢查碼不符。請再次上傳。
FIRStorageErrorCodeCanceled	使用者已取消操作。
FIRStorageErrorCodeDownloadSizeExceeded	下載的檔案大小超過為下載作業分配的記憶體容量。提高記憶體上限，然後再試一次。