Fehler für Cloud Storage im Web behandeln

Manchmal läuft beim Erstellen einer App nicht alles wie geplant und es tritt ein Fehler auf.

Prüfen Sie im Zweifelsfall den Error Handler (oder die catch()-Funktion für Promises) und sehen Sie sich die Fehlermeldung an.

Wenn Sie die Fehlermeldung geprüft haben und über Cloud Storage Security Rules verfügen, die Ihre Aktion zulassen, Sie den Fehler aber immer noch 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. weil die Datei nicht vorhanden ist, der Nutzer keine Berechtigung für den Zugriff auf die gewünschte Datei hat oder der Nutzer den Dateiupload abbricht.

Damit Sie das Problem richtig diagnostizieren und den Fehler beheben können, finden Sie hier eine vollständige Liste aller Fehler, die unser Client ausgibt, 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 Bucket wurde überschritten. Für Cloud Storage for Firebase ist das Blaze-Preismodell (Pay as you go) erforderlich. Wenn Sie diesen Fehler bei einem Projekt mit dem Spark-Preismodell erhalten, müssen Sie ein Upgrade auf das Blaze-Preismodell durchführen, um den Zugriff wiederherzustellen. Weitere Informationen finden Sie in den FAQs.
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, ob Ihre Sicherheitsregeln korrekt sind.
storage/retry-limit-exceeded Das maximale Zeitlimit für einen Vorgang (Upload, Download, Löschen usw.) überschritten wurde. Versuche, die Inhalte noch einmal hochzuladen.
storage/invalid-checksum Die Datei auf dem Client stimmt nicht mit der Prüfsumme der vom Server empfangenen Datei überein. Versuche, die Inhalte noch einmal hochzuladen.
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 Ungültige URL für refFromURL() 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 Roh-, „Base64“- oder „Base64URL“-String sein.
storage/no-default-bucket In der Property storageBucket Ihrer Firebase-Konfiguration wurde kein Bucket festgelegt.
storage/cannot-slice-blob Tritt häufig auf, wenn die lokale Datei geändert wurde (gelöscht, noch einmal gespeichert usw.). Versuchen Sie, die Datei noch einmal hochzuladen, nachdem Sie geprüft haben, dass sie nicht geändert wurde.
storage/server-file-wrong-size Die Datei auf dem Client stimmt nicht mit der Größe der vom Server empfangenen Datei überein. Versuche, die Inhalte noch einmal hochzuladen.