Fehler für Cloud Storage im Web behandeln

Manchmal läuft es beim Erstellen einer App nicht wie geplant 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

Es kann verschiedene Gründe für Fehler geben, z. B. dass die Datei nicht existiert, der Nutzer keine Berechtigung zum Zugriff auf 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 befindet sich kein Objekt.
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 Bucket Cloud Storage wurde überschritten. Wenn Sie den Spark-Tarif nutzen, sollten Sie ein Upgrade auf den Blaze-Tarif (Pay as you go) in Betracht ziehen. 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 Die maximale Zeitspanne für einen Vorgang (Upload, Download, Löschen usw.) wurde überschritten. Versuchen Sie es noch einmal.
storage/invalid-checksum Die Datei auf dem Client stimmt nicht mit der Prüfsumme der vom Server empfangenen Datei überein. Versuchen Sie es noch einmal.
storage/canceled Vorgang wurde vom Nutzer 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 In der storageBucket-Property 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.