Flutter'da Cloud Storage hatalarını işleme

Uygulama geliştirirken bazen işler planlandığı gibi gitmez ve hata meydana gelir.

Şüpheye düştüğünüzde işlevin attığı istisnayı yakalayın ve hata mesajında ne yazdığına bakın.

final storageRef = FirebaseStorage.instance.ref().child("files/uid");
try {
  final listResult = await storageRef.listAll();
} on FirebaseException catch (e) {
  // Caught an exception from Firebase.
  print("Failed with error '${e.code}': ${e.message}");
}

Hata mesajlarını işleme

Hataların oluşmasının birkaç nedeni olabilir. Bu nedenler arasında dosyanın mevcut olmaması, kullanıcının istenen dosyaya erişim izni olmaması veya kullanıcının dosya yüklemeyi iptal etmesi yer alır.

Sorunu doğru şekilde teşhis etmek ve hatayı gidermek için müşterimizin bildireceği tüm hataların ve nasıl oluştuklarının tam listesini burada bulabilirsiniz.

Kod Açıklama
storage/unknown Bilinmeyen bir hata oluştu.
storage/object-not-found İstenen referansta nesne yok.
storage/bucket-not-found Cloud Storage için paket yapılandırılmamış
storage/project-not-found Cloud Storage için yapılandırılmamış bir proje
storage/quota-exceeded Cloud Storage paketinizdeki kota aşıldı. Spark fiyatlandırma planını kullanıyorsanız kullan-öde Blaze fiyatlandırma planına geçiş yapabilirsiniz. Halihazırda Blaze fiyatlandırma planını kullanıyorsanız Firebase Destek Ekibi ile iletişime geçin.

Önemli: 1 Ekim 2025'ten itibaren, varsayılan paketler dahil olmak üzere Cloud Storage kullanmak için Blaze fiyatlandırma planının zorunludur.
storage/unauthenticated Kullanıcının kimliği doğrulanmadı. Lütfen kimliğinizi doğrulayın ve tekrar deneyin.
storage/unauthorized Kullanıcı, istenen işlemi gerçekleştirme yetkisine sahip değil. Güvenlik kurallarınızın doğru olduğundan emin olmak için kontrol edin.
storage/retry-limit-exceeded Bir işlemle (yükleme, indirme, silme vb.) ilgili maksimum süre aşıldı. Tekrar yüklemeyi deneyin.
storage/invalid-checksum İstemcideki dosya, sunucu tarafından alınan dosyanın sağlama toplamıyla eşleşmiyor. Tekrar yüklemeyi deneyin.
storage/canceled Kullanıcı işlemi iptal etti.
storage/invalid-event-name Geçersiz etkinlik adı sağlandı. [running, progress, pause] arasından biri olmalıdır.
storage/invalid-url refFromURL() için sağlanan URL geçersiz. Şu biçimde olmalıdır: gs://bucket/object veya https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>
storage/invalid-argument put() bağımsız değişkenine iletilen bağımsız değişken File, Blob veya UInt8 dizisi olmalıdır. putString() işlevine iletilen bağımsız değişken ham, Base64 veya Base64URL dizesi olmalıdır.
storage/no-default-bucket Yapılandırmanızın storageBucket mülkünde hiçbir paket ayarlanmadı.
storage/cannot-slice-blob Genellikle yerel dosya değiştiğinde (silindi, tekrar kaydedildi vb.) ortaya çıkar. Dosyanın değişmediğini doğruladıktan sonra tekrar yüklemeyi deneyin.
storage/server-file-wrong-size İstemcideki dosya, sunucu tarafından alınan dosyanın boyutuyla eşleşmiyor. Tekrar yüklemeyi deneyin.