ErrorCode

FCM hata koşulları için hata kodları.

Hata Kodu Açıklama ve Çözüm Adımları
UNSPECIFIED_ERROR Bu hata hakkında başka bilgi yok. Yok.
INVALID_ARGUMENT (HTTP hata kodu = 400) İstek parametreleri geçersizdi. Hangi alanın geçersiz olduğunu belirtmek için google.rpc.BadRequest türünde bir uzantı döndürülür. Olası nedenler arasında geçersiz kayıt, geçersiz paket adı, ileti çok büyük, geçersiz veri anahtarı, geçersiz TTL veya diğer geçersiz parametreler bulunur.
Geçersiz kayıt: Sunucuya ilettiğiniz kayıt jetonunun biçimini kontrol edin. Bu kodun, istemci uygulamasının FCM'ye kaydolma işleminden aldığı kayıt jetonuyla eşleştiğinden emin olun. Jetonu kırpmayın veya ek karakter eklemeyin.
Geçersiz paket adı: İletinin, paket adı istekte iletilen değerle eşleşen bir kayıt jetonuna yönlendirildiğinden emin olun.
İleti çok büyük: Bir iletiye dahil edilen yük verilerinin toplam boyutunun FCM sınırlarını aşmadığından emin olun: çoğu ileti için 4.096 bayt, konulara gönderilen iletilerde 2.048 bayt. Bu, hem anahtarları hem de değerleri içerir.
Geçersiz veri anahtarı: Yük verilerinde, FCM tarafından dahili olarak kullanılan bir anahtar (from, gcm ya da google ön ekine sahip herhangi bir değer gibi) bulunmadığından emin olun. FCM tarafından da bazı kelimelerin (örneğin collapse_key) kullanıldığını ancak yükte izin verildiğini unutmayın. Bu durumda yük değeri FCM değeri tarafından geçersiz kılınır.
Geçersiz TTL: ttl'da kullanılan değerin, 0 ile 2.419.200 (4 hafta) arasında saniye cinsinden bir süreyi temsil eden tam sayı olduğundan emin olun.
Geçersiz parametreler: Sağlanan parametrelerin doğru ada ve türe sahip olduğundan emin olun.
UNREGISTERED (HTTP hata kodu = 404) Uygulama örneğinin kaydı FCM'den kaldırıldı. Bu genellikle kullanılan jetonun artık geçerli olmadığı ve yeni bir jeton kullanılması gerektiği anlamına gelir. Bu hata, eksik kayıt jetonları veya kaydedilmemiş jetonlardan kaynaklanıyor olabilir.
Eksik Kayıt: İletinin hedefi bir token değeriyse isteğin kayıt jetonu içerip içermediğini kontrol edin.
Kayıtlı değil: Aşağıdakiler de dahil olmak üzere çeşitli senaryolarda mevcut bir kayıt jetonunun geçerliliği durdurulabilir:
- İstemci uygulamasının FCM'deki kaydı silinirse.
- İstemci uygulamasının kaydı otomatik olarak silinirse bu durum, kullanıcı uygulamanın yüklemesini kaldırırsa meydana gelebilir. Örneğin, iOS'te APNs Geri Bildirim Hizmeti APNs jetonunu geçersiz olarak bildirmiştir.
- Kayıt jetonunun süresi dolarsa (örneğin, Google kayıt jetonlarını yenilemeye karar verebilir veya iOS cihazlar için APNs jetonunun süresi dolmuş olabilir).
- İstemci uygulaması güncellenir, ancak yeni sürüm mesaj alacak şekilde yapılandırılmamışsa.
Tüm bu durumlarda, bu kayıt jetonunu uygulama sunucusundan kaldırın ve ileti göndermek için artık kullanmayın.
SENDER_ID_MISMATCH (HTTP hata kodu = 403) Kimliği doğrulanmış gönderen kimliği, kayıt jetonunun gönderen kimliğinden farklı. Kayıt jetonu, belirli bir gönderen grubuna bağlıdır. Bir istemci uygulaması FCM'ye kaydolduğunda, hangi gönderenlerin ileti göndermesine izin verildiğini belirtmesi gerekir. İstemci uygulamasına ileti gönderirken bu gönderen kimliklerinden birini kullanmalısınız. Farklı bir gönderene geçerseniz mevcut kayıt jetonları çalışmaz.
QUOTA_EXCEEDED (HTTP hata kodu = 429) İleti hedefi için gönderme sınırı aşıldı. Hangi kotanın aşıldığını belirtmek için google.rpc.QuotaFailure türünde bir uzantı döndürülür. Bu hata, ileti hızı kotasının veya cihaz ileti hızı kotasının aşılmasından ya da konu ileti hızı kotasının aşılmasından kaynaklanabilir.
İleti hızı aşıldı: İleti gönderme oranı çok yüksek. Toplam ileti gönderme hızınızı azaltmanız gerekir. Reddedilen iletileri yeniden denemek için minimum 1 dakikalık bir başlangıç gecikmesiyle eksponansiyel geri yükleme kullanın.
Cihaz mesaj hızı aşıldı: Belirli bir cihaza gönderilen mesaj oranı çok yüksek. Tek bir cihaza yönelik mesaj hızı sınırı başlıklı makaleyi inceleyin. Bu cihaza gönderilen ileti sayısını azaltın ve göndermeyi yeniden denemek için eksponansiyel geri yükleme kullanın.
Konu mesaj oranı aşıldı: Belirli bir konunun abonelerine gelen mesaj oranı çok yüksek. Bu konu için gönderilen mesaj sayısını azaltın ve göndermeyi yeniden denemek için en az 1 dakikalık bir başlangıç gecikmesiyle eksponansiyel geri yükleme kullanın.
UNAVAILABLE (HTTP hata kodu = 503) Sunucu aşırı yüklü. Sunucu isteği zamanında işleyemedi. Aynı isteği yeniden deneyin. Ancak şunları yapmanız gerekir:
- FCM Bağlantı Sunucusu'ndan gelen yanıtta yer alıyorsa Retry-After üstbilgisini dikkate alın.
- Yeniden deneme mekanizmanıza eksponansiyel geri yükleme uygulayın. (ör.ilk yeniden denemeden önce bir saniye beklediyseniz sonrakinden önce en az iki saniye, daha sonra 4 saniye bekleyin vb.). Birden çok mesaj gönderiyorsanız ses dalgalanması uygulamayı deneyin. Daha fazla bilgi için Yeniden denemeleri yönetme bölümüne bakın. Sorunlara neden olan gönderenler, reddedilenler listesine alınma riskiyle karşı karşıyadır.
INTERNAL (HTTP hata kodu = 500) Bilinmeyen dahili bir hata oluştu. Sunucu, isteği işlemeye çalışırken bir hatayla karşılaştı. Yeniden denemeleri yönetme bölümündeki önerileri izleyerek aynı isteği yeniden deneyebilirsiniz. Hata devam ederse lütfen Firebase destek ekibiyle iletişime geçin.
THIRD_PARTY_AUTH_ERROR (HTTP hata kodu = 401) APNs sertifikası veya web push kimlik doğrulama anahtarı geçersiz ya da eksikti. iOS cihaza hedeflenen bir mesaj veya web push kaydı gönderilemedi. Geliştirme ve üretim kimlik bilgilerinizin geçerliliğini kontrol edin.