آشنایی با کدهای خطا

این صفحه کدهای خطایی را که ممکن است با آن‌ها مواجه شوید فهرست می‌کند و پیشنهادهایی برای نحوه رفع هرکدام از آن‌ها ارائه می‌دهد.

DeadlineExceeded (262)

موارد زیر می‌تواند خطاهای DeadlineExceeded (262) را افزایش دهد:

  • افزایش تأخیر باعث شد که تکمیل عملیات بیشتر از مهلت مقرر (به‌طور پیش‌فرض ۶۰ ثانیه) طول بکشد.
DeadlineExceeded (262): Deadline exceeded.

برای حل این مشکل، راهنمای عیب‌یابی تأخیر را ببینید.

لغو شد (۱۱۲)

موقعیت‌های زیر می‌تواند خطاهای 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) شود:

  • تلاش برای ثبت سندی که از حد ۷٫۵ کیبی‌بایت برای ورودی نمایه فراتر رفته است.

‫۷٫۵ کیبی‌بایت حد ورودی‌های نمایه است. نمی‌توانید از این حد فراتر بروید و این سهمیه قابل‌تنظیم نیست.

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

برای حل‌وفصل کردن این مشکل:

برای مقادیر فیلد نمایه‌شده، فیلد را به چند فیلد تقسیم کنید. درصورت امکان، فیلد نمایه‌نشده ایجاد کنید و داده‌هایی را که لازم نیست نمایه شوند به فیلد نمایه‌نشده منتقل کنید.