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

Bazen uygulama geliştirirken işler planlandığı gibi gitmez ve hata oluşur.

Şüphe duyduğunuzda hata işleyiciyi (veya Promises 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 olmasına rağmen hatayı çözmekte zorlanıyorsanız destek sayfamızı ziyaret ederek size nasıl yardımcı olabileceğimizi bildirin.

Hata Mesajlarını İşleme

Hataların oluşmasının çeşitli nedenleri vardır. Örneğin, dosya mevcut olmayabilir, kullanıcının istenen dosyaya erişme izni olmayabilir veya kullanıcı dosya yüklemeyi iptal etmiş olabilir.

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

Kod Neden
storage/unknown Bilinmeyen bir hata oluştu.
storage/object-not-found Belirtilen referansta nesne yok.
storage/bucket-not-found Cloud Storage için yapılandırılmış bir paket yok
storage/project-not-found Cloud Storage için yapılandırılmış proje yok
storage/quota-exceeded Cloud Storage paketinizdeki kota aşıldı. Spark fiyatlandırma planını kullanıyorsanız kullandıkça öde Blaze fiyatlandırma planına geçmeyi düşünebilirsiniz. Blaze fiyatlandırma planını kullanıyorsanız Firebase Destek Ekibi ile iletişime geçin.

Önemli: 1 Ekim 2025'ten itibaren Cloud Storage (varsayılan paketler dahil) kullanmak için Blaze fiyatlandırma planı gerekli olacak.
storage/unauthenticated Kullanıcının kimliği doğrulanmadı. Lütfen kimlik doğrulama işlemini yapıp tekrar deneyin.
storage/unauthorized Kullanıcının istenen işlemi gerçekleştirme yetkisi yok. Güvenlik kurallarınızın doğru olduğundan emin olmak için bunları kontrol edin.
storage/retry-limit-exceeded Bir işlem için maksimum süre sınırı (yükleme, indirme, silme vb.) aşılmıştır. 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ı. Şunlardan biri olmalıdır: [`running`, `progress`, `pause`]
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() işlevine 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 Firebase yapılandırmanızın storageBucket özelliğinde herhangi bir paket ayarlanmamış.
storage/cannot-slice-blob Genellikle yerel dosya değiştiğinde (silindi, tekrar kaydedildi vb.) oluşur. 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.