Gestire gli errori per Cloud Storage sul web

A volte, durante la creazione di un'app, le cose non vanno come previsto e si verifica un errore.

In caso di dubbi, controlla il gestore degli errori (o la funzione catch() per le promesse) e vedi cosa dice il messaggio di errore.

Se hai controllato il messaggio di errore e disponi di Cloud Storage Security Rules che ti consentono di eseguire l'azione, ma non riesci ancora a risolvere l'errore, visita la nostra pagina di assistenza e comunicaci come possiamo aiutarti.

Gestire i messaggi di errore

Esistono diversi motivi per cui potrebbero verificarsi errori, tra cui il file non esistente, l'utente che non dispone dell'autorizzazione per accedere al file desiderato o l'utente che annulla il caricamento del file.

Per diagnosticare correttamente il problema e gestire l'errore, ecco un elenco completo di tutti gli errori che il nostro client genererà e come si sono verificati.

Codice Motivo
storage/unknown Si è verificato un errore sconosciuto.
storage/object-not-found Non esiste alcun oggetto nel riferimento specificato.
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 hai il piano tariffario Spark, valuta l'upgrade al piano tariffario Blaze con pagamento a consumo. Se hai già scelto 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. Esegui l'autenticazione e riprova.
storage/unauthorized L'utente non è autorizzato a eseguire l'azione richiesta. Controlla le regole di sicurezza per assicurarti che siano corrette.
storage/retry-limit-exceeded Il limite di tempo massimo per un'operazione (caricamento, download, eliminazione e così via) è stato superato. Prova a caricarlo di nuovo.
storage/invalid-checksum Il file sul client non corrisponde al checksum del file ricevuto dal server. Prova a caricarlo di nuovo.
storage/canceled L'utente ha annullato l'operazione.
storage/invalid-event-name Nome dell'evento fornito non valido. Deve essere uno dei seguenti 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=&ltTOKEN>
storage/invalid-argument L'argomento passato a put() deve essere `File`, `Blob` o array `UInt8`. L'argomento passato a putString() deve essere una stringa non elaborata, "Base64" o "Base64URL".
storage/no-default-bucket Nessun bucket è stato impostato nella proprietà storageBucket della configurazione Firebase.
storage/cannot-slice-blob Si verifica spesso quando il file locale è stato modificato (eliminato, salvato di nuovo, ecc.). Prova a caricare di nuovo il file dopo aver verificato che non sia stato modificato.
storage/server-file-wrong-size Il file sul client non corrisponde alle dimensioni del file ricevuto dal server. Prova a caricarlo di nuovo.