오류 코드 이해하기

이 페이지에는 발생할 수 있는 오류 코드가 나열되어 있으며 각 오류를 해결하는 방법에 대한 제안이 제공됩니다.

DEADLINE_EXCEEDED

다음으로 인해 DEADLINE_EXCEEDED 오류가 증가할 수 있습니다.

  • 지연 시간의 증가로 인해 작업이 완료되는 시간이 마감시간(기본적으로 60초)보다 오래 걸렸습니다.
DEADLINE_EXCEEDED

A deadline was exceeded on the server.

이 문제를 해결하려면 지연 시간 문제 해결 가이드를 참조하세요.

ABORTED

다음과 같은 경우 ABORTED 오류가 증가할 수 있습니다.

  • 초당 너무 많은 업데이트를 수신하는 문서
  • 겹쳐진 트랜잭션이 경합하는 경우
  • 트래픽이 500-50-5 규칙을 초과하거나 핫 스팟이 발생하는 경우
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바이트(1MiB - 89바이트)보다 큰 문서를 커밋하려고 시도합니다. 이 한도는 문서의 필드 값 합계에 적용됩니다. 예를 들어 각각 256KiB인 필드가 4개이면 한도가 초과됩니다.

필드 값의 한도는 색인이 생성된 경우 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

이 문제를 해결하려면 다음 안내를 따르세요.

  • 색인이 생성된 필드 값의 경우 필드를 여러 필드로 분할합니다. 가능하면 색인이 생성되지 않은 필드를 만들고 색인을 생성할 필요가 없는 데이터를 색인이 생성되지 않은 필드로 이동합니다.
  • 색인이 생성되지 않은 필드 값의 경우 필드를 여러 필드로 분할하거나 필드 값에 대한 압축을 구현합니다.