رموز الخطأ لشروط فشل FCM.
| خطا بالكود | الوصف وخطوات الحل |
|---|---|
UNSPECIFIED_ERROR لا يتوفر المزيد من المعلومات حول هذا الخطأ. | لا أحد. |
INVALID_ARGUMENT (رمز خطأ HTTP = 400) معلمات الطلب غير صالحة. يتم إرجاع ملحق من النوع google.rpc.BadRequest لتحديد الحقل غير الصالح. | تتضمن الأسباب المحتملة تسجيلًا غير صالح، أو اسم حزمة غير صالح، أو رسالة كبيرة جدًا، أو مفتاح بيانات غير صالح، أو TTL غير صالح، أو معلمات أخرى غير صالحة. تسجيل غير صالح : تحقق من تنسيق رمز التسجيل الذي قمت بتمريره إلى الخادم. تأكد من أنه يطابق رمز التسجيل الذي يتلقاه تطبيق العميل من التسجيل في FCM. لا تقم باقتطاع الرمز المميز أو إضافة أحرف إضافية. اسم الحزمة غير صالح : تأكد من أن الرسالة موجهة إلى رمز التسجيل الذي يتطابق اسم الحزمة الخاص به مع القيمة التي تم تمريرها في الطلب. الرسالة كبيرة جدًا : تأكد من أن الحجم الإجمالي لبيانات الحمولة المضمنة في الرسالة لا يتجاوز حدود FCM: 4096 بايت لمعظم الرسائل، أو 2048 بايت في حالة الرسائل إلى المواضيع. يتضمن ذلك المفاتيح والقيم. مفتاح بيانات غير صالح : تأكد من أن بيانات الحمولة لا تحتوي على مفتاح (مثل من، أو gcm، أو أي قيمة تسبقها google) يتم استخدامه داخليًا بواسطة FCM. لاحظ أن بعض الكلمات (مثلlapse_key) تُستخدم أيضًا بواسطة FCM ولكنها مسموح بها في الحمولة النافعة، وفي هذه الحالة سيتم تجاوز قيمة الحمولة النافعة بقيمة FCM. TTL غير صالح : تأكد من أن القيمة المستخدمة في ttl هي عدد صحيح يمثل مدة بالثواني بين 0 و2,419,200 (4 أسابيع). المعلمات غير صالحة : تأكد من أن المعلمات المقدمة لها الاسم والنوع الصحيحان. |
UNREGISTERED (رمز خطأ HTTP = 404) تم إلغاء تسجيل مثيل التطبيق من FCM. وهذا يعني عادةً أن الرمز المميز المستخدم لم يعد صالحًا ويجب استخدام رمز جديد. | يمكن أن يحدث هذا الخطأ بسبب فقدان رموز التسجيل المميزة أو الرموز المميزة غير المسجلة. التسجيل مفقود : إذا كان هدف الرسالة عبارة عن قيمة token ، فتأكد من أن الطلب يحتوي على رمز مميز للتسجيل.غير مسجل : قد يتوقف صلاحية رمز التسجيل الحالي في عدد من السيناريوهات، بما في ذلك: - إذا تم إلغاء تسجيل تطبيق العميل لدى FCM. - إذا تم إلغاء تسجيل تطبيق العميل تلقائيًا، وهو ما يمكن أن يحدث إذا قام المستخدم بإلغاء تثبيت التطبيق. على سبيل المثال، في نظام التشغيل iOS، إذا أبلغت خدمة تعليقات APNs عن أن رمز APNs غير صالح. - إذا انتهت صلاحية رمز التسجيل المميز (على سبيل المثال، قد تقرر Google تحديث رموز التسجيل المميزة، أو انتهت صلاحية رمز APNs المميز لأجهزة iOS). - إذا تم تحديث تطبيق العميل ولكن الإصدار الجديد لم يتم تكوينه لتلقي الرسائل. في كل هذه الحالات، قم بإزالة رمز التسجيل هذا من خادم التطبيق وتوقف عن استخدامه لإرسال الرسائل. |
SENDER_ID_MISMATCH (رمز خطأ HTTP = 403) يختلف معرف المرسل المصادق عليه عن معرف المرسل الخاص برمز التسجيل. | يرتبط رمز التسجيل بمجموعة معينة من المرسلين. عندما يقوم تطبيق عميل بالتسجيل في FCM، يجب عليه تحديد المرسلين المسموح لهم بإرسال الرسائل. يجب عليك استخدام أحد معرفات المرسل عند إرسال الرسائل إلى تطبيق العميل. إذا قمت بالتبديل إلى مرسل مختلف، فلن تعمل رموز التسجيل الحالية. |
QUOTA_EXCEEDED (رمز خطأ HTTP = 429) تم تجاوز حد الإرسال لهدف الرسالة. يتم إرجاع ملحق من النوع google.rpc.QuotaFailure لتحديد الحصة النسبية التي تم تجاوزها. | يمكن أن يحدث هذا الخطأ بسبب تجاوز الحصة النسبية لمعدل الرسائل، أو تجاوز الحصة النسبية لمعدل رسائل الجهاز، أو تجاوز الحصة النسبية لمعدل رسائل الموضوع. تم تجاوز معدل الرسائل : معدل إرسال الرسائل مرتفع جدًا. يجب عليك تقليل المعدل الإجمالي الذي ترسل به الرسائل. استخدم التراجع الأسي مع تأخير مبدئي لا يقل عن دقيقة واحدة لإعادة محاولة الرسائل المرفوضة. تم تجاوز معدل رسائل الجهاز : معدل الرسائل إلى جهاز معين مرتفع جدًا. راجع حد معدل الرسائل لجهاز واحد . قم بتقليل عدد الرسائل المرسلة إلى هذا الجهاز واستخدم التراجع الأسي لإعادة محاولة الإرسال. تم تجاوز معدل رسائل الموضوع : معدل الرسائل المرسلة إلى المشتركين في موضوع معين مرتفع جدًا. قم بتقليل عدد الرسائل المرسلة لهذا الموضوع واستخدم التراجع الأسي مع تأخير أولي أدنى قدره دقيقة واحدة لإعادة محاولة الإرسال. |
UNAVAILABLE (رمز خطأ HTTP = 503) تم تحميل الخادم بشكل زائد. | تعذر على الخادم معالجة الطلب في الوقت المناسب. أعد محاولة نفس الطلب، لكن يجب عليك: - قم بتكريم رأس "إعادة المحاولة بعد" إذا تم تضمينه في الاستجابة من خادم اتصال FCM. - تنفيذ التراجع الأسي في آلية إعادة المحاولة الخاصة بك. (على سبيل المثال، إذا انتظرت ثانية واحدة قبل إعادة المحاولة الأولى، فانتظر ثانيتين على الأقل قبل المحاولة التالية، ثم 4 ثوانٍ وهكذا). إذا كنت ترسل رسائل متعددة، ففكر في تطبيق الارتعاش. لمزيد من المعلومات، راجع التعامل مع إعادة المحاولة . المرسلون الذين يتسببون في حدوث مشكلات يتعرضون لخطر إدراجهم في القائمة المرفوضة. |
INTERNAL (رمز خطأ HTTP = 500) حدث خطأ داخلي غير معروف. | واجه الخادم خطأ أثناء محاولة معالجة الطلب. يمكنك إعادة محاولة نفس الطلب باتباع الاقتراحات الموجودة في معالجة إعادة المحاولة . إذا استمر الخطأ، فيرجى الاتصال بدعم Firebase. |
THIRD_PARTY_AUTH_ERROR (رمز خطأ HTTP = 401) كانت شهادة APNs أو مفتاح مصادقة دفع الويب غير صالح أو مفقود. | لا يمكن إرسال رسالة موجهة إلى جهاز iOS أو تسجيل دفع على الويب. تحقق من صحة بيانات اعتماد التطوير والإنتاج الخاصة بك. |