瞭解錯誤代碼

僅適用於 Cloud Firestore Enterprise 版。

本頁面列出您可能會遇到的錯誤代碼，並提供各項錯誤的修正建議。

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.

如何解決這個問題：

  • 如果流量快速增加，與 MongoDB 相容的 Cloud Firestore 會嘗試自動擴充，以滿足增加的需求。與 MongoDB 相容的 Cloud Firestore 擴充規模後，延遲時間就會開始縮短。
  • 熱點會限制與 MongoDB 相容的 Cloud Firestore 擴充能力。請參閱資源調度設計，找出資源使用率不均的區域。
  • 請查看交易中的資料爭用情況，以及交易的使用情形。
  • 降低個別文件的寫入速度。

InvalidArgument (2)

下列情況可能會導致 InvalidArgument (2) 錯誤：

  • 嘗試提交的文件超過索引項目的 7.5 KiB 限制。

索引項目的限制為 7.5 KiB。你無法超過這個上限，而且這不是可以調整的配額。

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

如何解決這個問題：

如為已建立索引的欄位值，請將欄位分割為多個欄位。如有可能，請建立未編入索引的欄位，並將不需要編入索引的資料移至該欄位。