现已推出具有 MongoDB 兼容性的 Firestore 企业版！
了解详情。
درک کدهای خطا
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
| فقط مربوط به Cloud Firestore Enterprise edition. |
این صفحه کدهای خطایی را که ممکن است با آنها مواجه شوید فهرست می‌کند و پیشنهادهایی برای رفع هر کدام از آنها ارائه می‌دهد.
مهلت بیش از حد (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 با سازگاری MongoDB تلاش می کند تا به طور خودکار مقیاس شود تا تقاضای افزایش یافته را برآورده کند. هنگامی که Cloud Firestore با مقیاس سازگاری MongoDB، تاخیر شروع به کاهش می کند.
- نقاط داغ توانایی Cloud Firestore با سازگاری MongoDB را برای افزایش مقیاس محدود می کند. بررسی طراحی برای مقیاس برای شناسایی نقاط داغ.
- اختلاف داده ها در تراکنش ها و استفاده شما از تراکنش ها را بررسی کنید.
- نرخ نوشتن اسناد را کاهش دهید.
InvalidArgument (2)
شرایط زیر می تواند باعث خطاهای InvalidArgument (2) شود:
- تلاش برای انجام یک سند با آن بیش از حد 7.5 کیلوبایت برای ورودی فهرست است.
7.5 کیلوبایت محدودیتی برای ورودی های فهرست است. شما نمی توانید از این حد تجاوز کنید و این یک سهمیه قابل تنظیم نیست.
InvalidArgument (2): Index entry on field_name is larger than 7680 bytes.
برای حل این مشکل:
برای مقادیر فیلد نمایه شده، فیلد را به چندین فیلد تقسیم کنید. در صورت امکان، یک فیلد فهرست‌نشده ایجاد کنید و داده‌هایی را که نیازی به ایندکس شدن ندارند به فیلد فهرست‌نشده منتقل کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["\u003cbr /\u003e\n\n\n|--------------------------------------------------------|\n| *Relevant to Cloud Firestore Enterprise edition only.* |\n\n\u003cbr /\u003e\n\nThis page lists error codes that you might encounter and provides suggestions\nfor how to fix each of them.\n\nDeadlineExceeded (262)\n\nThe following can increase `DeadlineExceeded (262)` errors:\n\n- An increase in latency caused an operation to take longer than the deadline (60 seconds by default) to complete.\n\n DeadlineExceeded (262): Deadline exceeded.\n\nTo resolve this issue, see the [guide to troubleshooting latency](/docs/firestore/enterprise/resolve-latency).\n\nAborted (112)\n\nThe following situations can increase `Aborted (112)` errors:\n\n- A document receiving too many updates per second.\n- Contention from overlapping transactions.\n- Traffic that increases rapidly or encounters hot-spots.\n\n Aborted (112): Too much contention on these documents. Please try again\n\nOr \n\n Aborted (112): Aborted due to cross-transaction contention. This occurs when\n multiple transactions attempt to access the same data, requiring at least one\n to be aborted in order to enforce serializability.\n\nTo resolve this issue:\n\n- For rapid traffic increases, Cloud Firestore with MongoDB compatibility attempts to automatically scale to meet the increased demand. When Cloud Firestore with MongoDB compatibility scales, latency begins to decrease.\n- Hot-spots limit the ability of Cloud Firestore with MongoDB compatibility to scale up. Review [designing for scale](/docs/firestore/enterprise/understand-reads-writes-scale#avoid_hotspots) to identify hot-spots.\n- Review [data contention in transactions](/docs/firestore/enterprise/understand-reads-writes-scale#high-level_steps_in_a_write_transaction) and your usage of transactions.\n- Reduce the write rate to individual documents.\n\nInvalidArgument (2)\n\nThe following situations can cause `InvalidArgument (2)` errors:\n\n- Attempting to commit a document with that exceeds the 7.5 KiB limit for an index entry.\n\n7.5 KiB is a [limit](/docs/firestore/enterprise/quotas) for index entries. You cannot exceed this limit\nand it's not a quota that can be adjusted. \n\n InvalidArgument (2): Index entry on \u003cvar class=\"readonly\" translate=\"no\"\u003efield_name\u003c/var\u003e is larger than 7680 bytes.\n\nTo resolve this issue:\n\nFor indexed field values, split the\nfield into multiple fields. If possible, create an un-indexed field\nand move data that doesn't need to be indexed into the un-indexed\nfield."]]
