Gestire gli errori di Cloud Storage sulle piattaforme Apple

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

In caso di dubbi, controlla l'errore restituito e il messaggio di errore.

Se hai controllato il messaggio di errore e hai Cloud Storage Security Rules che consentono la tua azione, ma hai ancora difficoltà 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 possono verificarsi errori, tra cui il file non esiste, l'utente non ha l'autorizzazione per accedere al file desiderato o lo utente ha annullato 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 di come possono verificarsi.

Nome Motivo
FIRStorageErrorCodeUnknown Si è verificato un errore sconosciuto.
FIRStorageErrorCodeObjectNotFound Non esiste alcun oggetto nel riferimento specificato.
FIRStorageErrorCodeBucketNotFound Nessun bucket configurato per Cloud Storage.
FIRStorageErrorCodeProjectNotFound Nessun progetto configurato per Cloud Storage.
FIRStorageErrorCodeQuotaExceeded È stata superata la quota del bucket Cloud Storage. Se hai il piano tariffario Spark, valuta l'upgrade al piano tariffario Blaze con pagamento a consumo. Se hai già il piano tariffario Blaze, contatta l'assistenza Firebase.

Importante: a partire dal 3 febbraio 2026, il piano tariffario Blaze sarà obbligatorio per utilizzare Cloud Storage, anche per i bucket predefiniti.
FIRStorageErrorCodeUnauthenticated L'utente non è autenticato. Autenticati e riprova.
FIRStorageErrorCodeUnauthorized L'utente non è autorizzato a eseguire l'azione richiesta. Controlla che le regole siano corrette.
FIRStorageErrorCodeRetryLimitExceeded È stato superato il limite di tempo massimo per un'operazione (caricamento, download, eliminazione e così via). Riprova a caricare il video.
FIRStorageErrorCodeNonMatchingChecksum Il file sul client non corrisponde al checksum del file ricevuto dal server. Riprova a caricare il video.
FIRStorageErrorCodeCanceled L'utente ha annullato l'operazione.
FIRStorageErrorCodeDownloadSizeExceeded Le dimensioni del file scaricato superano la quantità di memoria allocata per il download. Aumenta il limite di memoria e riprova a scaricare il file.