FCM arıza koşulları için hata kodları.
| Hata kodu | Açıklama ve Çözüm Adımları |
|---|---|
UNSPECIFIED_ERROR Bu hata hakkında daha fazla bilgi mevcut değil. | Hiçbiri. |
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ı, çok büyük mesaj, geçersiz veri anahtarı, geçersiz TTL veya diğer geçersiz parametreler yer alır. Geçersiz kayıt : Sunucuya ilettiğiniz kayıt jetonunun biçimini kontrol edin. İstemci uygulamasının FCM'ye kaydolurken aldığı kayıt jetonuyla eşleştiğinden emin olun. Belirteci kesmeyin veya ek karakterler eklemeyin. Geçersiz paket adı : İletinin, paket adı istekte iletilen değerle eşleşen bir kayıt belirtecine gönderildiğinden emin olun. Mesaj çok büyük : Bir mesaja dahil edilen yük verilerinin toplam boyutunun FCM sınırlarını aşmadığını kontrol edin: çoğu mesaj için 4096 bayt veya konulara yönelik mesajlar için 2048 bayt. Buna hem anahtarlar hem de değerler dahildir. Geçersiz veri anahtarı : Yük verilerinin, FCM tarafından dahili olarak kullanılan bir anahtar (from, gcm veya google'ın ön eki olan herhangi bir değer gibi) içermediğini kontrol edin. Bazı kelimelerin (çöküş_anahtarı gibi) da FCM tarafından kullanıldığını ancak veri yükünde izin verildiğini, bu durumda veri yükü değerinin FCM değeri tarafından geçersiz kılınacağını unutmayın. Geçersiz TTL : ttl'de kullanılan değerin, 0 ile 2.419.200 (4 hafta) arasında saniye cinsinden bir süreyi temsil eden bir tam sayı olup olmadığını kontrol edin. Geçersiz parametreler : Sağlanan parametrelerin doğru ada ve türe sahip olup olmadığını kontrol edin. |
UNREGISTERED (HTTP hata kodu = 404) Uygulama örneğinin FCM'deki kaydı kaldırıldı. Bu genellikle kullanılan tokenın artık geçerli olmadığı ve yeni bir token kullanılması gerektiği anlamına gelir. | Bu hata, eksik kayıt belirteçlerinden veya kaydedilmemiş belirteçlerden kaynaklanabilir. Eksik Kayıt : Mesajın hedefi bir token değeri ise isteğin bir kayıt belirteci içerip içermediğini kontrol edin.Kayıtlı değil : Mevcut bir kayıt jetonunun geçerliliği, aşağıdakiler de dahil olmak üzere çeşitli senaryolarda sona erebilir: - İstemci uygulamasının FCM'deki kaydı silinirse. - İstemci uygulamasının kaydı otomatik olarak silinirse, bu durum kullanıcının uygulamayı kaldırması durumunda meydana gelebilir. Örneğin, iOS'ta APN Geri Bildirim Hizmeti, APN belirtecinin geçersiz olduğunu bildirdiyse. - 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şsa). - İstemci uygulaması güncellendiyse ancak yeni sürüm mesaj alacak şekilde yapılandırılmadıysa. Tüm bu durumlarda, bu kayıt jetonunu uygulama sunucusundan kaldırın ve mesaj göndermek için kullanmayı bırakın. |
SENDER_ID_MISMATCH (HTTP hata kodu = 403) Kimliği doğrulanmış gönderen kimliği, kayıt belirtecinin gönderen kimliğinden farklıdır. | Bir kayıt jetonu belirli bir gönderen grubuna bağlanır. Bir istemci uygulaması FCM'ye kaydolduğunda hangi gönderenlerin mesaj göndermesine izin verildiğini belirtmelidir. İstemci uygulamasına mesaj 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, mesaj hızı kotasının aşılması, cihaz mesaj hızı kotasının aşılması veya konu mesaj hızı kotasının aşılmasından kaynaklanabilir. Mesaj hızı aşıldı : Mesajların gönderilme hızı çok yüksek. Genel mesaj gönderme hızınızı azaltmalısınız. Reddedilen mesajları yeniden denemek için minimum başlangıç gecikmesi olan üstel geri çekmeyi kullanın. Cihaz mesaj hızı aşıldı : Belirli bir cihaza gönderilen mesajların oranı çok yüksek. Tek bir cihaza yönelik mesaj hızı sınırına bakın . Bu cihaza gönderilen mesajların sayısını azaltın ve göndermeyi yeniden denemek için üstel gerilemeyi kullanın. Konu mesaj oranı aşıldı : Belirli bir konuya ilişkin abonelere gönderilen mesaj oranı çok yüksek. Bu konu için gönderilen iletilerin sayısını azaltın ve göndermeyi yeniden denemek için minimum başlangıç gecikmesi olan üstel gerilemeyi kullanın. |
UNAVAILABLE (HTTP hata kodu = 503) Sunucu aşırı yüklenmiş. | Sunucu isteği zamanında işleyemedi. Aynı isteği yeniden deneyin, ancak şunları yapmalısınız: - FCM Bağlantı Sunucusundan gelen yanıtta yer alıyorsa Retry-Aft başlığını dikkate alın. - Yeniden deneme mekanizmanıza üstel geri çekilme uygulayın. (örneğin, ilk tekrar denemeden önce bir saniye beklediyseniz, bir sonraki denemeden önce en az iki saniye bekleyin, ardından 4 saniye vb. bekleyin). Birden fazla mesaj gönderiyorsanız titremeyi uygulamayı düşünün. Daha fazla bilgi için bkz . Yeniden denemeleri işleme . Soruna neden olan gönderenler reddedilen listeye alınma riskiyle karşı karşıyadır. |
INTERNAL (HTTP hata kodu = 500) Bilinmeyen bir dahili hata oluştu. | Sunucu, isteği işlemeye çalışırken bir hatayla karşılaştı. Yeniden denemeleri işleme bölümündeki önerileri izleyerek aynı isteği yeniden deneyebilirsiniz . Hata devam ederse lütfen Firebase desteğiyle iletişime geçin. |
THIRD_PARTY_AUTH_ERROR (HTTP hata kodu = 401) APN sertifikası veya web push kimlik doğrulama anahtarı geçersiz veya eksikti. | Bir iOS cihazını veya web push kaydını hedefleyen bir mesaj gönderilemedi. Geliştirme ve üretim kimlik bilgilerinizin geçerliliğini kontrol edin. |