處理 Apple 平台上 Cloud Storage 的錯誤

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

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

如果您已查看錯誤訊息，並且有 Cloud Storage Security Rules 可執行操作，但仍無法修正錯誤，請前往支援頁面，告訴我們如何提供協助。

處理錯誤訊息

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

為正確診斷問題並處理錯誤，以下列出客戶會產生的所有錯誤，以及這些錯誤發生的原因。

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