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.

Im Zweifelsfall sollten Sie den Fehlerhandler (oder die catch()-Funktion für Promises) prüfen und sich die Fehlermeldung ansehen.

Wenn Sie die Fehlermeldung überprüft haben und Cloud Storage Security Rules für die Aktion haben, die Aktion aber weiterhin nicht ausführen können, rufen Sie unsere Supportseite auf und teilen Sie uns mit, wie wir Ihnen helfen können.

Fehlermeldungen verarbeiten

Fehler können aus verschiedenen Gründen auftreten, z. B. wenn die Datei nicht vorhanden ist, der Nutzer keine Zugriffsberechtigung für die gewünschte Datei hat oder der Nutzer den Dateiupload abbricht.

Damit wir das Problem richtig diagnostizieren und den Fehler beheben können, findest du hier eine vollständige Liste aller Fehler, die unser Kunde meldet, und wie sie aufgetreten sind.

Code Grund
storage/unknown Ein unbekannter Fehler ist aufgetreten.
storage/object-not-found An 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 im Bucket Cloud Storage wurde überschritten. Wenn Sie das Spark-Preismodell haben, können Sie ein Upgrade auf das „Pay as you go“-Preismodell „Blaze“ ausführen. Wenn Sie bereits den Blaze-Tarif nutzen, wenden Sie sich an den Firebase-Support.

Wichtig: Ab dem 1. Oktober 2025 ist der Blaze-Tarif erforderlich, um Cloud Storage zu verwenden, auch Standard-Buckets.
storage/unauthenticated Der Nutzer ist nicht authentifiziert. Bitte 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 (z. B. Hochladen, Herunterladen, Löschen) wurde überschritten. Versuchen Sie es noch einmal.
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.
storage/canceled Der Nutzer hat den Vorgang abgebrochen.
storage/invalid-event-name Ungültiger Ereignisname angegeben. Muss einer der folgenden Werte sein: [`running`, `progress`, `pause`]
storage/invalid-url Für refFromURL() wurde eine ungültige URL angegeben. Muss das Format gs://bucket/object oder https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN> haben.
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 Im Attribut storageBucket Ihrer Firebase-Konfiguration wurde kein Bucket festgelegt.
storage/cannot-slice-blob Tritt häufig auf, wenn sich die lokale Datei geändert hat (z. B. gelöscht oder noch einmal gespeichert wurde). Versuchen Sie noch einmal, die Datei hochzuladen, nachdem Sie sich vergewissert haben, dass sie sich 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.