處理 Apple 平台上 Cloud Storage 的錯誤

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

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

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

處理錯誤訊息

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

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

名稱 原因
FIRStorageErrorCodeUnknown 發生不明錯誤。
FIRStorageErrorCodeObjectNotFound 指定參照位置沒有物件。
FIRStorageErrorCodeBucketNotFound 尚未為 Cloud Storage 設定任何 bucket。
FIRStorageErrorCodeProjectNotFound Cloud Storage 未設定任何專案。
FIRStorageErrorCodeQuotaExceeded 您已超過 Cloud Storage bucket 的配額。如果目前採用 Spark 定價方案，建議升級至即付即用的 Blaze 定價方案。如果目前採用 Blaze 定價方案，請與 Firebase 支援團隊聯絡。

重要事項：2025 年 10 月 1 日起，使用 Cloud Storage (包括預設 bucket) 時，必須採用 Blaze 定價方案。
FIRStorageErrorCodeUnauthenticated 使用者未通過驗證。請驗證身分，然後再試一次。
FIRStorageErrorCodeUnauthorized 使用者沒有執行要求動作的權限。檢查規則是否正確。
FIRStorageErrorCodeRetryLimitExceeded 作業 (上傳、下載、刪除等) 超過時間上限。請重新上傳。
FIRStorageErrorCodeNonMatchingChecksum 用戶端上的檔案與伺服器收到的檔案總和檢查碼不符。請重新上傳。
FIRStorageErrorCodeCanceled 使用者已取消操作。
FIRStorageErrorCodeDownloadSizeExceeded 下載的檔案大小超過為下載作業分配的記憶體容量。提高記憶體上限，然後再試一次。