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

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

Şüphe duyduğunuzda hata işleyiciyi (veya Promise'ler için catch() işlevini) kontrol edin ve hata mesajının ne söylediğine bakı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ı işleme

Dosyanın mevcut olmaması, kullanıcının istediği 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 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=&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ş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.