Gestire gli errori di Cloud Storage su Android

A volte le cose non vanno come previsto e si verifica un errore.

In caso di dubbi, controlla l'errore restituito e il messaggio di errore. Il seguente codice mostra un'implementazione di un gestore di errori personalizzato che esamina il codice di errore e il messaggio di errore restituiti da Cloud Storage. Questi gestori di errori possono essere aggiunti a vari oggetti utilizzati nell'API Cloud Storage (ad esempio, UploadTask e FileDownloadTask).

Kotlin

internal inner class MyFailureListener : OnFailureListener {
    override fun onFailure(exception: Exception) {
        val errorCode = (exception as StorageException).errorCode
        val errorMessage = exception.message
        // test the errorCode and errorMessage, and handle accordingly
    }
}
StorageActivity.kt

Java

class MyFailureListener implements OnFailureListener {
    @Override
    public void onFailure(@NonNull Exception exception) {
        int errorCode = ((StorageException) exception).getErrorCode();
        String errorMessage = exception.getMessage();
        // test the errorCode and errorMessage, and handle accordingly
    }
}
StorageActivity.java

Se hai controllato il messaggio di errore e hai Cloud Storage Security Rules che consentono la tua azione, ma hai ancora difficoltà a correggere 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 l'utente 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 di come possono verificarsi. I codici di errore in questa tabella sono definiti nella classe StorageException come costanti intere.

Codice Motivo
ERROR_UNKNOWN Si è verificato un errore sconosciuto.
ERROR_OBJECT_NOT_FOUND Non esiste alcun oggetto nel riferimento specificato.
ERROR_BUCKET_NOT_FOUND Nessun bucket configurato per Cloud Storage
ERROR_PROJECT_NOT_FOUND Nessun progetto configurato per Cloud Storage
ERROR_QUOTA_EXCEEDED È 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 i bucket predefiniti.
ERROR_NOT_AUTHENTICATED L'utente non è autenticato. Autenticati e riprova.
ERROR_NOT_AUTHORIZED L'utente non è autorizzato a eseguire l'azione richiesta. Controlla le regole per assicurarti che siano corrette.
ERROR_RETRY_LIMIT_EXCEEDED È stato superato il limite di tempo massimo per un'operazione (caricamento, download, eliminazione e così via). Riprova.
ERROR_INVALID_CHECKSUM Il file sul client non corrisponde al checksum del file ricevuto dal server. Riprova a caricare il video.
ERROR_CANCELED L'utente ha annullato l'operazione.

Inoltre, se tenti di chiamare getReferenceFromUrl() con un URL non valido, verrà generata un'eccezione IllegalArgumentException. L'argomento a il metodo precedente deve essere nel formato gs://bucket/object o https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>