Web'de Cloud Storage hatalarını işleme

Bazen bir uygulama geliştirirken işler planlandığı gibi gitmez ve bir hata meydana gelir.

Şüpheye düştüğünüzde hata işleyiciyi (veya Promises için catch() işlevini) kontrol edin ve hata mesajında ne yazan olduğunu görün.

Hata mesajını kontrol ettiyseniz ve işleminize izin veren Cloud Storage Security Rules'ye sahipseniz ancak hatayı çözmekte hâlâ sorun yaşıyorsanız Destek sayfamızı ziyaret edin ve size nasıl yardımcı olabileceğimizi bildirin.

Hata Mesajlarını İş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 Neden
storage/unknown Bilinmeyen bir hata oluştu.
storage/object-not-found Belirtilen referanstaki nesne yok.
storage/bucket-not-found Cloud Storage için yapılandırılmış paket yok
storage/project-not-found Cloud Storage için yapılandırılan proje yok
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. Doğru olduğundan emin olmak için güvenlik kurallarınızı kontrol edin.
storage/retry-limit-exceeded Bir işlemle (yükleme, indirme, silme vb.) ilgili maksimum zaman sınırı 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 Sağlanan etkinlik adı geçersiz. [`running`, `progress`, `pause`] değerlerinden biri olmalıdır
storage/invalid-url refFromURL() için geçersiz URL sağlandı. Şu biçimde olmalıdır: gs://bucket/object veya https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>
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() bağımsız değişkenine iletilen bağımsız değişken, ham,
storage/no-default-bucket Firebase yapılandırmanızın storageBucket mülkünde bir paket ayarlanmadı.
storage/cannot-slice-blob Genellikle yerel dosya değiştirildiğinde (silindiğinde, tekrar kaydedildiğinde vb.) oluşur. 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.