ウェブで Cloud Storage のエラーを処理する

アプリをビルドする際、思いどおりにいかなかったり、エラーが発生したりすることがあります。

理由がわからないときは、エラーハンドラ（または Promises の 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 日より、デフォルト バケットでも Cloud Storage を使用するには、Blaze 料金プランが必要になります。
storage/unauthenticated 承認されていないユーザーです。認証してから、もう一度お試しください。
storage/unauthorized 要求された操作を行う権限がユーザーにありません。セキュリティ ルールが正しいことをご確認ください。
storage/retry-limit-exceeded オペレーション（アップロード、ダウンロード、削除など）の最大時間制限超過しました。もう一度アップロードしてみてください。
storage/invalid-checksum クライアント上のファイルが、サーバーで受信されたファイルのチェックサムと一致しません。もう一度アップロードしてみてください。
storage/canceled ユーザーがオペレーションをキャンセルしました。
storage/invalid-event-name 無効なイベント名が指定されました。`running`、`progress`、`pause` のいずれかにする必要があります。
storage/invalid-url 無効な URL が refFromURL() に指定されました。gs://bucket/object または https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN> の形式で指定してください。
storage/invalid-argument put() に渡される引数は `File`、` Blob`、または `UInt8` 配列である必要があります。putString() に渡される引数は、raw、`Base64`、または `Base64URL` の文字列である必要があります。
storage/no-default-bucket 構成ファイルの storageBucket プロパティにバケットが設定されていません。
storage/cannot-slice-blob 一般的に、ローカル ファイルの変更時（削除、再保存など）に発生します。ファイルが変更されていないことを確認した後で、もう一度アップロードしてみてください。
storage/server-file-wrong-size クライアント上のファイルが、サーバーで受信されたファイルのサイズと一致しません。もう一度アップロードしてみてください。