處理 Apple 平台上 Cloud Storage 的錯誤

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

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

注意： 根據預設，Cloud Storage for Firebase 值區會要求 Firebase Authentication 對值區的資料或檔案執行任何動作。您可以將 Firebase Security Rules 變更為 Cloud Storage，在特定情況下允許未經驗證的存取權。不過，在大多數情況下，我們強烈建議您限制存取權並設定完善的安全性規則 (尤其是正式版應用程式)。請注意，如果您使用 Google App Engine，且預設 Cloud Storage 儲存格式為 *.appspot.com，可能需要考量安全性規則如何影響 App Engine 檔案的存取權。

如果您已查看錯誤訊息，並且有 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	下載檔案的大小超過分配用於下載的記憶體。請提高記憶體上限，然後再試著下載。