Fehler für Cloud Storage in Flutter behandeln

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

Im Zweifelsfall sollten Sie die von der Funktion ausgelöste Ausnahme abfangen und sich die Fehlermeldung ansehen.

final storageRef = FirebaseStorage.instance.ref().child("files/uid");
try {
  final listResult = await storageRef.listAll();
} on FirebaseException catch (e) {
  // Caught an exception from Firebase.
  print("Failed with error '${e.code}': ${e.message}");
}

Hinweis :Standardmäßig ist für alle Aktionen auf den Daten oder Dateien eines Cloud Storage for Firebase-Buckets Firebase Authentication erforderlich. 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 bei Produktions-Apps. 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.

Umgang mit Fehlermeldungen

Es kann verschiedene Gründe für Fehler geben, z. B. dass die Datei nicht vorhanden ist, der Nutzer keine Berechtigung zum Zugriff auf die gewünschte Datei hat oder der Nutzer den Dateiupload abbricht.

Damit das Problem richtig diagnostiziert und behoben werden kann, finden Sie im Folgenden eine vollständige Liste aller Fehler, die unser Client ausgeben wird, und wie sie aufgetreten sind.

Code	Beschreibung
storage/unknown	Ein unbekannter Fehler ist aufgetreten.
storage/object-not-found	An der gewünschten 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 wurde 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 Pay-as-you-go-Tarif Blaze 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 gewünschte Aktion auszuführen. Prüfen Sie Ihre Sicherheitsregeln auf ihre Richtigkeit.
storage/retry-limit-exceeded	Das maximale Zeitlimit für einen Vorgang (z. B. Upload, Download oder 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	Vorgang wurde vom Nutzer abgebrochen.
storage/invalid-event-name	Ungültiger Ereignisname angegeben. Muss eine der folgenden Optionen 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=<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 Rohstring, ein Base64-String oder ein Base64URL-String sein.
storage/no-default-bucket	In der storageBucket-Eigenschaft Ihrer 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.