瞭解錯誤代碼

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

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

InvalidArgument (2)

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

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

索引項目的限制為 7.5 KiB。 您無法超過這項限制,且這不是可調整的配額。

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

如何解決這個問題:

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