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

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

DeadlineExceeded (262)

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

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

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

تم الإلغاء (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.

لحلّ هذه المشكلة، يُرجى اتّباع الخطوات التالية:

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