오류 코드 이해하기
이 페이지에는 발생할 수 있는 오류 코드가 나열되어 있으며 각 오류를 해결하는 방법에 관한 제안이 제공됩니다.
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, or perhaps the entire file system is out of space.
이 문제를 해결하려면 다음 안내를 따르세요.
- 무료 계층의 일일 재설정을 기다리거나 프로젝트 결제를 사용 설정합니다.
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
이 문제를 해결하려면 다음 안내를 따르세요.
- 색인이 생성된 필드 값의 경우 필드를 여러 필드로 분할합니다. 가능하면 색인이 생성되지 않은 필드를 만들고 색인을 생성할 필요가 없는 데이터를 색인이 생성되지 않은 필드로 이동합니다.
- 색인이 생성되지 않은 필드 값의 경우 필드를 여러 필드로 분할하거나 필드 값에 대한 압축을 구현합니다.