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

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

Şüphe duyduğunuzda işlev tarafından oluşturulan istisnayı yakalayıp hata mesajında ne yazdığını kontrol edin.

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

Dosyanın mevcut olmaması, kullanıcının istenen dosyaya erişme izninin olmaması veya kullanıcının dosya yüklemeyi iptal etmesi gibi çeşitli nedenlerle hata oluşabilir.

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

Kod Açıklama
storage/unknown Bilinmeyen bir hata oluştu.
storage/object-not-found İstenilen referansta nesne yok.
storage/bucket-not-found Cloud Storage için yapılandırılmamış bir paket yok
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ğinden emin olduktan 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.