فهم رموز الخطأ

تعرض هذه الصفحة رموز الأخطاء التي قد تظهر لك وتقدّم اقتراحات حول كيفية حلّ كل منها.

‫DeadlineExceeded (262)

يمكن أن تؤدي الحالات التالية إلى زيادة أخطاء DeadlineExceeded (262):

  • تسبّبت زيادة في وقت الاستجابة في استغراق عملية وقتًا أطول من المهلة المحدّدة (60 ثانية تلقائيًا) لإكمالها.
DeadlineExceeded (262): Deadline exceeded.

لحلّ هذه المشكلة، يُرجى الاطّلاع على دليل تحديد المشاكل المتعلّقة بوقت الاستجابة وحلّها.

‫Aborted (112)

يمكن أن تؤدي الحالات التالية إلى زيادة أخطاء Aborted (112):

  • تلقّي مستند عددًا كبيرًا جدًا من التعديلات في الثانية.
  • التنافس على البيانات من المعاملات المتداخلة.
  • الزيارات التي تزداد بسرعة أو تواجه نقاطًا ساخنة.
Aborted (112): Too much contention on these documents. Please try again

أو

Aborted (112): Aborted due to cross-transaction contention. This occurs when
multiple transactions attempt to access the same data, requiring at least one
to be aborted in order to enforce serializability.

لحلّ هذه المشكلة، عليك تنفيذ ما يلي:

  • بالنسبة إلى الزيادات السريعة في الزيارات، Cloud Firestore تحاول التوسّع تلقائيًا لتلبية الطلب المتزايد. عندما تتوسّع خدمة Cloud Firestore ، يبدأ وقت الاستجابة في الانخفاض.
  • تحدّ النقاط الساخنة من قدرة Cloud Firestore على التوسّع. راجِع مقالة التصميم من أجل التوسّع لتحديد النقاط الساخنة.
  • راجِع التنافس على البيانات في المعاملات واستخدامك للمعاملات.
  • قلِّل معدّل الكتابة في المستندات الفردية.

‫InvalidArgument (2)

يمكن أن تؤدي الحالات التالية إلى ظهور أخطاء InvalidArgument (2):

  • محاولة تنفيذ مستند يتجاوز الحدّ الأقصى البالغ 7.5 كيلوبايت لإدخال الفهرس.

الحدّ الأقصى لإدخالات الفهرس هو 7.5 كيلوبايت. لا يمكنك تجاوز هذا الحدّ، وهو ليس حصة يمكن تعديلها.

InvalidArgument (2): Index entry on field_name is larger than 7680 bytes.

لحلّ هذه المشكلة، عليك تنفيذ ما يلي:

بالنسبة إلى قيم الحقول المفهرسة، قسِّم الحقل إلى حقول متعددة. إذا أمكن، أنشئ حقلًا غير مفهرس وانقل البيانات التي لا تحتاج إلى فهرستها إلى الحقل غير المفهرس.