Fehler für Cloud Storage im Web behandeln

Manchmal läuft bei der Entwicklung einer App nicht alles nach Plan und es tritt ein Fehler auf.

In diesem Fall sollten Sie den Fehlerhandler (oder die Funktion catch() für Promises) prüfen und die Fehlermeldung lesen.

Wenn Sie die Fehlermeldung geprüft haben und Ihre Cloud Storage Security Rules die Aktion zulassen, Sie den Fehler aber trotzdem nicht beheben können, rufen Sie unsere Supportseite auf und teilen Sie uns mit, wie wir Ihnen helfen können.

Fehlermeldungen verarbeiten

Es gibt eine Reihe von Gründen, warum Fehler auftreten können, z. B. wenn die Datei nicht vorhanden ist, der Nutzer keine Berechtigung für den Zugriff auf die gewünschte Datei hat oder der Nutzer den Upload der Datei abbricht.

Um das Problem richtig zu diagnostizieren und den Fehler zu beheben, finden Sie hier eine vollständige Liste aller Fehler, die unser Client auslösen kann, und wie sie aufgetreten sind.

Code Grund
storage/unknown Ein unbekannter Fehler ist aufgetreten.
storage/object-not-found Unter der angegebenen Referenz ist kein Objekt vorhanden.
storage/bucket-not-found Für Cloud Storage ist kein Bucket konfiguriert.
storage/project-not-found Für Cloud Storage ist kein Projekt konfiguriert.
storage/quota-exceeded Das Kontingent für Ihren Cloud Storage Bucket wurde überschritten. Wenn Sie den Spark-Tarif verwenden, sollten Sie ein Upgrade auf den Blaze-Tarif (Pay as you go) durchführen. Wenn Sie bereits den Blaze-Preismodell verwenden, wenden Sie sich an den Firebase-Support.

Wichtig: Ab dem 3. Februar 2026 ist der Blaze-Preismodell erforderlich, um Cloud Storage zu verwenden, auch für Standard-Buckets.
storage/unauthenticated Der Nutzer ist nicht authentifiziert. Authentifizieren Sie sich und versuchen Sie es noch einmal.
storage/unauthorized Der Nutzer ist nicht berechtigt, die angeforderte Aktion auszuführen. Prüfen Sie Ihre Sicherheitsregeln, um sicherzustellen, dass sie korrekt sind.
storage/retry-limit-exceeded Das maximale Zeitlimit für einen Vorgang (Upload, Download, Löschen usw.) wurde überschritten. Versuchen Sie es noch einmal mit dem Upload.
storage/invalid-checksum Die Datei auf dem Client stimmt nicht mit der Prüfsumme der Datei überein, die vom Server empfangen wurde. Versuchen Sie es noch einmal mit dem Upload.
storage/canceled Der Nutzer hat den Vorgang abgebrochen.
storage/invalid-event-name Es wurde ein ungültiger Ereignisname angegeben. Er muss einer der folgenden Werte sein: [`running`, `progress`, `pause`]
storage/invalid-url Für refFromURL() wurde eine ungültige URL angegeben. Sie muss das folgende Format haben: gs://bucket/object oder https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>
storage/invalid-argument Das an put() übergebene Argument muss ein `File`-, `Blob`- oder `UInt8`-Array sein. Das an putString() übergebene Argument muss ein Rohstring, ein `Base64`-String oder ein `Base64URL`-String sein.
storage/no-default-bucket In der Eigenschaft storageBucket Ihrer Firebase-Konfiguration wurde kein Bucket festgelegt.
storage/cannot-slice-blob Tritt häufig auf, wenn sich die lokale Datei geändert hat (gelöscht, noch einmal gespeichert, usw.). Versuchen Sie es noch einmal mit dem Upload, nachdem Sie geprüft haben, dass sich die Datei nicht geändert hat.
storage/server-file-wrong-size Die Datei auf dem Client stimmt nicht mit der Größe der Datei überein, die vom Server empfangen wurde. Versuchen Sie es noch einmal mit dem Upload.