Fehler für Cloud Storage in Flutter behandeln

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

Im Zweifelsfall können 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 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 Beschreibung
storage/unknown Ein unbekannter Fehler ist aufgetreten.
storage/object-not-found Unter der gewünschten 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 gewünschte 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.) wurde überschritten. Versuche, die Inhalte noch einmal hochzuladen.
storage/invalid-checksum Die Datei auf dem Client stimmt nicht mit der Prüfsumme der Datei überein, die vom Server empfangen wurde. 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=<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 Property storageBucket Ihrer 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.). Prüfen Sie, ob die Datei geändert wurde, und versuchen Sie dann noch einmal, sie hochzuladen.
storage/server-file-wrong-size Die Datei auf dem Client stimmt nicht mit der Größe der Datei überein, die vom Server empfangen wurde. Versuche, die Inhalte noch einmal hochzuladen.