處理網頁版 Cloud Storage 的錯誤

有時在開發應用程式的過程中 發生錯誤!

有疑慮時,請檢查錯誤處理常式 (若為 Promise,請查看 catch() 函式), 查看錯誤訊息的內容

如果您查看錯誤訊息,且擁有允許 Cloud Storage 安全性規則 但仍無法解決錯誤,請造訪我們的 請支援網頁,告訴我們您需要哪方面的協助。

處理錯誤訊息

導致發生錯誤的原因有很多,包括檔案 非現有檔案、使用者無權存取所需檔案,或 使用者取消上傳檔案。

為了正確診斷問題並處理錯誤,請參考以下完整清單, 用戶端發生的所有錯誤,以及這些錯誤發生的方式

程式碼 原因
storage/unknown 發生不明錯誤。
storage/object-not-found 所需的參照中沒有物件。
storage/bucket-not-found Cloud Storage 未設定任何值區
storage/project-not-found 未設定 Cloud Storage 專案
storage/quota-exceeded 您的 Cloud Storage 值區已超過配額。 如果您使用的是免付費方案,請升級至付費方案,當您開啟 付費方案,請與 Firebase 支援團隊聯絡。
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 設定中尚未設有任何值區 storageBucket 屬性。
storage/cannot-slice-blob 一般來說,當本機檔案變更 (刪除、再次儲存、 等)。確認檔案未成功,請重新上傳 已變更。
storage/server-file-wrong-size 用戶端上的檔案與 伺服器請重新上傳。