處理網頁版 Cloud Storage 的錯誤

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

如有疑問,請查看錯誤處理常式 (或 Promise 的 catch() 函式),看看錯誤訊息的說法。

如果您已查看錯誤訊息,並且已取得可執行操作的 Cloud Storage Security Rules,但仍無法解決錯誤,請造訪我們的支援頁面,並告訴我們如何提供協助。

處理錯誤訊息

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

為正確診斷問題並處理錯誤,以下列出客戶會發生的所有錯誤,以及發生錯誤的方式。

程式碼 原因
storage/unknown 發生不明錯誤。
storage/object-not-found 指定參照項目中沒有物件。
storage/bucket-not-found 未設定「Cloud Storage」的值區
storage/project-not-found 未為 Cloud Storage 設定專案
storage/quota-exceeded 您已超過 Cloud Storage 儲存桶的配額。如果您採用 Spark 定價方案,建議您升級至即付即用的 Blaze 定價方案。如果你已採用 Blaze 定價方案,請與 Firebase 支援團隊聯絡。

重要事項:自 2025 年 10 月 1 日起,Blaze 定價方案將必須採用 Cloud Storage (包括預設值區)。
storage/unauthenticated 使用者未經過驗證,請驗證使用者身分,然後再試一次。
storage/unauthorized 使用者未經授權,無法執行要求的動作,請檢查安全性規則,確認規則正確無誤。
storage/retry-limit-exceeded 作業 (上傳、下載、刪除等) 的時間上限已超過。請嘗試重新上傳。
storage/invalid-checksum 用戶端的檔案與伺服器收到的檔案總和檢查碼不符。請嘗試重新上傳。
storage/canceled 使用者已取消作業。
storage/invalid-event-name 提供的事件名稱無效。必須是下列其中一個: [`running`, `progress`, `pause`]
storage/invalid-url 提供給 refFromURL() 的網址無效。格式必須為:gs://bucket/object 或 https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>
storage/invalid-argument 傳遞至 put() 的引數必須是 `File`、`Blob` 或 `UInt8` 陣列。傳遞至 putString() 的引數必須是原始字串、Base64 或「Base64URL」字串。
storage/no-default-bucket Firebase 設定的 storageBucket 屬性中未設定任何值。
storage/cannot-slice-blob 通常發生在本機檔案變更 (刪除、再次儲存等) 時。請確認檔案未變更後,再嘗試重新上傳。
storage/server-file-wrong-size 用戶端上的檔案與伺服器收到的檔案大小不符。請嘗試重新上傳。