Gestire gli errori di Cloud Storage su Flutter

A volte, quando crei un'app, le cose non vanno come previsto e si verifica un errore.

In caso di dubbio, intercetta l'eccezione lanciata dalla funzione e controlla cosa dice il messaggio di errore.

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

Nota: per impostazione predefinita, un bucket Cloud Storage for Firebase richiede Firebase Authentication per eseguire qualsiasi azione sui dati o sui file del bucket. Puoi sostituire Firebase Security Rules con Cloud Storage per consentire l'accesso non autenticato per situazioni specifiche. Tuttavia, per la maggior parte delle situazioni, ti consigliamo vivamente di limitare l'accesso e configurare regole di sicurezza efficaci (soprattutto per le app di produzione). Tieni presente che se utilizzi Google App Engine e hai un bucket Cloud Storage predefinito con un formato del nome *.appspot.com, potresti dover considerare in che modo le tue regole di sicurezza influiscono sull'accesso ai file App Engine.

Gestire i messaggi di errore

Esistono diversi motivi per cui potrebbero verificarsi errori, tra cui il fatto che il file non esista, che l'utente non abbia l'autorizzazione per accedere al file desiderato o che l'utente abbia annullato il caricamento del file.

Per diagnosticare correttamente il problema e gestire l'errore, di seguito è riportato un elenco completo di tutti gli errori che il nostro cliente solleva e di come si sono verificati.

Codice	Descrizione
storage/unknown	Si è verificato un errore sconosciuto.
storage/object-not-found	Non esiste alcun oggetto al riferimento desiderato.
storage/bucket-not-found	Nessun bucket è configurato per Cloud Storage
storage/project-not-found	Nessun progetto è configurato per Cloud Storage
storage/quota-exceeded	La quota del bucket Cloud Storage è stata superata. Se utilizzi il piano tariffario Spark, ti consigliamo di eseguire l'upgrade al piano tariffario Blaze con pagamento a consumo. Se utilizzi già il piano tariffario Blaze, contatta l'assistenza Firebase. Importante: a partire dal 1° ottobre 2025, il piano tariffario Blaze sarà obbligatorio per utilizzare Cloud Storage, anche i bucket predefiniti.
storage/unauthenticated	L'utente non è autenticato. Effettua l'autenticazione e riprova.
storage/unauthorized	L'utente non è autorizzato a eseguire l'azione desiderata. Controlla le regole di sicurezza per assicurarti che siano corrette.
storage/retry-limit-exceeded	È stato superato il limite di tempo massimo per un'operazione (caricamento, download, eliminazione e così via). Riprova a caricare il video.
storage/invalid-checksum	Il file sul client non corrisponde al checksum del file ricevuto dal server. Riprova a caricare il video.
storage/canceled	L'utente ha annullato l'operazione.
storage/invalid-event-name	Nome dell'evento non valido fornito. Deve essere uno dei valori [running, progress, pause]
storage/invalid-url	L'URL fornito a refFromURL() non è valido. Deve essere nel formato: gs://bucket/object o https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>
storage/invalid-argument	L'argomento passato a put() deve essere un array File, Blob o UInt8. L'argomento passato a putString() deve essere una stringa non elaborata, Base64 o Base64URL.
storage/no-default-bucket	Non è stato impostato alcun bucket nella proprietà storageBucket della configurazione.
storage/cannot-slice-blob	Si verifica di solito quando il file locale è stato modificato (eliminato, salvato di nuovo e così via). Prova a eseguire nuovamente il caricamento dopo aver verificato che il file non sia cambiato.
storage/server-file-wrong-size	Le dimensioni del file sul client non corrispondono a quelle del file ricevuto dal server. Riprova a caricare il video.