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 Funktion catch() für Promises) prüfen und die Fehlermeldung lesen.
Wenn Sie die Fehlermeldung geprüft haben und Cloud Storage Security Rules vorhanden sind, die Ihre 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. Dazu gehören beispielsweise, dass 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 Bucket wurde überschritten. Cloud Storage for Firebase erfordert den Blaze-Tarif (Pay as you go). Wenn dieser Fehler in einem Projekt mit dem Spark-Tarif auftritt, müssen Sie auf den Blaze-Tarif upgraden, um wieder Zugriff zu erhalten. Weitere Informationen finden Sie in unseren FAQs. |
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 noch einmal, die Datei hochzuladen. |
storage/invalid-checksum |
Die Datei auf dem Client stimmt nicht mit der Prüfsumme der vom Server empfangenen Datei überein. Versuchen Sie noch einmal, die Datei hochzuladen. |
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 Format „
gs://bucket/object“ oder „https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>“ 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 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 noch einmal, die Datei hochzuladen, nachdem Sie geprüft 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 vom Server empfangenen Datei überein. Versuchen Sie noch einmal, die Datei hochzuladen. |