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}");
}

Fehlermeldungen verarbeiten

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 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 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 Kein Projekt für Cloud Storage 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 autorisiert, die gewünschte 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. 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 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 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- 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.