瞭解錯誤代碼

本頁列出您可能會遇到的錯誤代碼,並提供相應的修正方式建議。

DEADLINE_EXCEEDED

下列情況可能會增加 DEADLINE_EXCEEDED 錯誤:

  • 延遲時間增加,導致作業時間超過期限 (預設為 60 秒)。
DEADLINE_EXCEEDED

A deadline was exceeded on the server.

如要解決這個問題,請參閱延遲時間疑難排解指南。

ABORTED

下列情況可能會導致 ABORTED 錯誤增加:

  • 文件每秒收到的更新過多。
  • 重疊交易造成的爭用。
  • 流量快速增加,超過負載拆分速度或遇到熱點。
ABORTED

Too much contention on these datastore entities. Please try again.

或

ABORTED

Aborted due to cross-transaction contention. This occurs when multiple
transactions attempt to access the same data, requiring Firestore to abort at
least one in order to enforce serializability.

如何解決這個問題:

  • 如果流量快速增加,Firestore 會嘗試自動調度資源,以因應增加的需求。Firestore 擴充後,延遲時間就會開始縮短。
  • 熱點會限制 Firestore 的擴充能力,請參閱擴充設計,瞭解如何找出熱點。
  • 請查看交易中的資料爭用和交易使用情形。
  • 降低個別文件的寫入速率。

RESOURCE_EXHAUSTED

下列情況可能會導致 RESOURCE_EXHAUSTED 錯誤:

  • 您已超出免費方案配額,且專案未啟用計費功能。

  • 未遵循最佳做法增加流量

RESOURCE_EXHAUSTED

Some resource has been exhausted, perhaps a per-user quota.

或

RESOURCE_EXHAUSTED

This database has exceeded their daily quota or the ramp up limit for writes, please retry with exponential backoff. To learn more about limits, see 'Usage and limits' section of the support documentation.

如何解決這個問題:

  • 如果已達到免費方案配額,請等待每日免費方案配額重設,或為專案啟用計費功能。

  • 如果流量快速增加,Firestore 會嘗試自動調度資源,以因應增加的需求。Firestore 擴充後,錯誤率可能會降低。

  • 熱點會限制 Firestore 的擴充能力。請參閱擴充性設計,瞭解如何找出熱點。

  • 如果是即時監聽器查詢,請確保查詢範圍不會過廣。使用篩選器減少更新次數。

INVALID_ARGUMENT

下列情況可能會導致 INVALID_ARGUMENT 錯誤:

  • 嘗試提交已建立索引的欄位值大於 1,500 個位元組的文件。這項限制適用於欄位值的 UTF-8 編碼。
  • 嘗試提交未建立索引的欄位值大於 1,048,487 位元組 (1 MiB - 89 位元組) 的文件。這項限制適用於文件中欄位值的總和。例如,四個欄位各 256 KiB 就會超過限制。

欄位值的限制為 1,500 個位元組 (已建立索引) 和 1,048,487 個位元組 (未建立索引)。您無法超過這些限制,且這些限制並非可調整的配額。

INVALID_ARGUMENT: The value of property field-name is longer than 1500 bytes

或

INVALID_ARGUMENT: The value of property field_name is longer than 1048487 bytes

如何解決這個問題:

  • 如果是已建立索引的欄位值,請將欄位分割為多個欄位。如果可以,請建立未建立索引的欄位,並將不需要建立索引的資料移至未建立索引的欄位。
  • 對於未建立索引的欄位值,請將欄位分割成多個欄位,或對欄位值實作壓縮。