Gestire gli errori di Cloud Storage sulle piattaforme Apple

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

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

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 l'impatto delle tue regole di sicurezza sull'accesso ai file App Engine.

Se hai controllato il messaggio di errore e disponi di Cloud Storage Security Rules che consentono l'azione, ma continui a riscontrare difficoltà a correggere l'errore, visita la nostra pagina di assistenza e facci sapere come possiamo aiutarti.

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 client solleva e di come possono verificarsi.

Nome	Motivo
FIRStorageErrorCodeUnknown	Si è verificato un errore sconosciuto.
FIRStorageErrorCodeObjectNotFound	Non esiste alcun oggetto al riferimento specificato.
FIRStorageErrorCodeBucketNotFound	Nessun bucket è configurato per Cloud Storage.
FIRStorageErrorCodeProjectNotFound	Nessun progetto è configurato per Cloud Storage.
FIRStorageErrorCodeQuotaExceeded	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.
FIRStorageErrorCodeUnauthenticated	L'utente non è autenticato. Esegui l'autenticazione e riprova.
FIRStorageErrorCodeUnauthorized	L'utente non è autorizzato a eseguire l'azione richiesta. Controlla le regole per assicurarti che 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.