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.

Hinweis: Standardmäßig benötigt ein Cloud Storage for Firebase-Bucket Firebase Authentication, um Aktionen für die Daten oder Dateien des Buckets auszuführen. Sie können Firebase Security Rules in Cloud Storage ändern, um den nicht authentifizierten Zugriff für bestimmte Situationen zuzulassen. In den meisten Fällen empfehlen wir jedoch dringend, den Zugriff einzuschränken und robuste Sicherheitsregeln einzurichten (insbesondere für Produktionsanwendungen). Wenn Sie Google App Engine verwenden und einen Standard-Cloud Storage-Bucket mit dem Namensformat *.appspot.com haben, müssen Sie möglicherweise berücksichtigen, wie sich Ihre Sicherheitsregeln auf den Zugriff auf App Engine-Dateien auswirken.

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.