Menangani error untuk Cloud Storage di platform Apple

Terkadang, ketika Anda membuat aplikasi, ada hal-hal yang tidak berjalan sesuai rencana dan terjadi error.

Jika merasa ragu, periksa error yang ditampilkan, dan lihat isi pesan error tersebut.

Catatan: Secara default, bucket Cloud Storage for Firebase memerlukan Firebase Authentication untuk melakukan tindakan apa pun pada data atau file bucket. Anda dapat mengubah Firebase Security Rules untuk Cloud Storage guna mengizinkan akses tanpa autentikasi untuk situasi tertentu. Namun, untuk sebagian besar situasi, sebaiknya batasi akses dan siapkan aturan keamanan yang kuat (terutama untuk aplikasi produksi). Perhatikan bahwa jika menggunakan Google App Engine dan memiliki bucket Cloud Storage default dengan format nama *.appspot.com, Anda mungkin perlu mempertimbangkan dampak aturan keamanan Anda terhadap akses ke file App Engine.

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 beberapa alasan mengapa terjadi error, termasuk tidak adanya file, pengguna tidak memiliki izin untuk mengakses file yang diinginkan, atau pengguna membatalkan upload file.

Untuk mendiagnosis masalah dan menangani error dengan benar, berikut adalah daftar lengkap semua error yang dialami klien kita, dan alasan error tersebut terjadi.

Nama	Alasan
FIRStorageErrorCodeUnknown	Terjadi error tak dikenal.
FIRStorageErrorCodeObjectNotFound	Tidak ada objek pada referensi yang ditentukan.
FIRStorageErrorCodeBucketNotFound	Tidak ada bucket yang dikonfigurasi untuk Cloud Storage.
FIRStorageErrorCodeProjectNotFound	Tidak ada bucket yang dikonfigurasi untuk Cloud Storage.
FIRStorageErrorCodeQuotaExceeded	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.
FIRStorageErrorCodeUnauthenticated	Pengguna tidak diautentikasi. Autentikasi pengguna tersebut, dan coba lagi.
FIRStorageErrorCodeUnauthorized	Pengguna tidak memiliki izin untuk melakukan tindakan yang diminta. Periksa aturan Anda untuk memastikan bahwa aturan tersebut sudah benar.
FIRStorageErrorCodeRetryLimitExceeded	Anda telah melebihi batas waktu maksimum suatu operasi (upload, download, hapus, dll.). Coba upload lagi.
FIRStorageErrorCodeNonMatchingChecksum	File pada klien tidak cocok dengan checksum file yang diterima oleh server. Coba upload lagi.
FIRStorageErrorCodeCanceled	Pengguna membatalkan operasi.
FIRStorageErrorCodeDownloadSizeExceeded	Ukuran file yang didownload melampaui jumlah memori yang dialokasikan untuk download. Naikkan batas memori dan coba download lagi.