處理 C++ 適用的 Cloud Storage 錯誤

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

有疑慮時,請檢查傳回的錯誤,並查看錯誤訊息的對應內容。

如果您查看錯誤訊息且 Cloud Storage Security Rules 支援執行動作,但仍無法順利修正錯誤,請前往支援頁面告訴我們您需要哪方面的協助。

處理錯誤訊息

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

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

名稱 原因
kErrorNone 沒有任何錯誤。
kErrorUnknown 發生不明錯誤。
kErrorObjectNotFound 指定的參照中沒有物件。
kErrorBucketNotFound 未設定「Cloud Storage」的值區。
kErrorProjectNotFound 未設定「Cloud Storage」專案。
kErrorQuotaExceeded 已超過 Cloud Storage 值區的配額。如果您採用 Spark 定價方案,建議您升級至即付即用的 Blaze 定價方案。如果你已採用 Blaze 定價方案,請與 Firebase 支援團隊聯絡。

重要事項:自 2025 年 10 月 1 日起,Blaze 定價方案將必須採用 Cloud Storage (包括預設值區)。
kErrorUnauthenticated 使用者未經過驗證。請驗證後再試一次。
kErrorUnauthorized 使用者未經授權,無法執行要求的動作。檢查規則,確認規則正確無誤。
kErrorRetryLimitExceeded 作業 (上傳、下載、刪除等) 的時間上限已超過。請嘗試重新上傳。
kErrorNonMatchingChecksum 用戶端的檔案與伺服器收到的檔案總和檢查碼不符。請嘗試重新上傳。
kErrorCanceled 使用者已取消作業。
kErrorDownloadSizeExceeded 下載的檔案大小超過下載作業所分配的記憶體量。請提高記憶體上限,然後再試著下載。