Menangani error untuk Cloud Storage di Android

Terkadang beberapa hal tidak berjalan sesuai rencana dan terjadi error.

Jika merasa ragu, periksa error yang ditampilkan, lalu lihat isi pesannya. Kode berikut menunjukkan implementasi pengendali error khusus yang memeriksa kode error dan pesan error yang ditampilkan oleh Cloud Storage. Pengendali error tersebut dapat ditambahkan ke beragam objek yang digunakan dalam Cloud Storage API (misalnya, UploadTask dan 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

Jika Anda telah memeriksa pesan error dan memiliki Cloud Storage Security Rules yang mengizinkan tindakan Anda, tetapi masih kesulitan dalam memperbaiki error tersebut, buka halaman Dukungan dan beri tahu kami bantuan apa yang diperlukan.

Menangani Pesan Error

Ada sejumlah alasan terjadinya error, di antaranya adalah tidak adanya file, pengguna tidak memiliki izin untuk mengakses file yang diinginkan, atau pengguna membatalkan upload file.

Untuk mendiagnosis masalah dan menangani error dengan tepat, baca daftar lengkap berikut yang berisi semua error yang mungkin dialami klien kami, beserta penyebab setiap error. Kode error dalam tabel ini ditentukan dalam class StorageException sebagai konstanta bilangan bulat.

Kode Alasan
ERROR_UNKNOWN Terjadi error tak dikenal.
ERROR_OBJECT_NOT_FOUND Tidak ada objek pada referensi yang ditentukan.
ERROR_BUCKET_NOT_FOUND Tidak ada bucket yang dikonfigurasi untuk Cloud Storage
ERROR_PROJECT_NOT_FOUND Tidak ada project yang dikonfigurasi untuk Cloud Storage
ERROR_QUOTA_EXCEEDED Kuota di bucket Cloud Storage telah terlampaui. Jika Anda menggunakan paket harga Spark, pertimbangkan untuk mengupgrade ke paket harga Blaze bayar sesuai penggunaan. Jika Anda sudah menggunakan paket harga Blaze, hubungi Dukungan Firebase.

Penting: Mulai 1 Oktober 2025, paket harga Blaze akan diperlukan untuk menggunakan Cloud Storage, bahkan bucket default.
ERROR_NOT_AUTHENTICATED Pengguna tidak terautentikasi. Autentikasi pengguna, lalu coba lagi.
ERROR_NOT_AUTHORIZED Pengguna tidak memiliki izin untuk melakukan tindakan yang diminta. Periksa aturan Anda untuk memastikan bahwa aturan tersebut sudah benar.
ERROR_RETRY_LIMIT_EXCEEDED Anda telah melebihi batas waktu maksimum suatu operasi (upload, download, hapus, dll.). Coba lagi.
ERROR_INVALID_CHECKSUM File pada klien tidak cocok dengan checksum file yang diterima oleh server. Coba upload lagi.
ERROR_CANCELED Pengguna membatalkan operasi.

Selain itu, IllegalArgumentException akan ditampilkan jika getReferenceFromUrl() dipanggil dengan URL yang tidak valid. Argumen untuk metode di atas harus berupa gs://bucket/object atau https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>