Saiba os códigos de erro
Nesta página, listamos códigos de erro que você pode encontrar e fornecemos sugestões de como corrigir cada um deles.
DEADLINE_EXCEEDED
Os seguintes erros podem aumentar a quantidade de erros DEADLINE_EXCEEDED:
- Um aumento na latência fez com que uma operação demore mais do que o prazo (60 segundos por padrão) para ser concluída.
DEADLINE_EXCEEDED A deadline was exceeded on the server.
Para resolver esse problema, consulte o guia para solucionar problemas de latência.
ABORTED
As seguintes situações podem aumentar a quantidade de erros ABORTED:
- Um documento que recebe muitas atualizações por segundo.
- Contenção de transações sobrepostas.
- Aumentos de tráfego que excedem a regra 500-50-5 ou encontram pontos de acesso.
ABORTED Too much contention on these datastore entities. Please try again.
Ou
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.
Para resolver o problema:
- Para aumentos rápidos no tráfego, o Firestore tenta escalonar automaticamente para atender ao aumento na demanda. Quando o Firestore é escalonado, a latência começa a diminuir.
- Os pontos de acesso limitam a capacidade do Firestore de escalonar verticalmente. Consulte a seção Como criar em escala para identificar pontos de acesso.
- Analise a contenção de dados em transações e o uso das transações.
- Reduza a taxa de gravação em documentos individuais.
RESOURCE_EXHAUSTED
As seguintes situações podem causar erros RESOURCE_EXHAUSTED:
Você excedeu a cota de nível gratuito, e o faturamento não está ativado para o projeto.
Aumentos no tráfego que não seguem as práticas recomendadas
RESOURCE_EXHAUSTED Some resource has been exhausted, perhaps a per-user quota.
Ou
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.
Para resolver o problema:
Se você atingiu a cota do nível gratuito, aguarde a redefinição diária ou ative o faturamento do projeto.
Para aumentos rápidos no tráfego, o Firestore tenta escalonar automaticamente para atender ao aumento na demanda. Quando o Firestore é escalonado, os erros podem diminuir.
Os pontos de acesso limitam a capacidade do Firestore de escalonar verticalmente. Analise o design para escala e identifique pontos de acesso.
Para consultas de listener em tempo real, verifique se elas não são desnecessariamente amplas. Use filtros para reduzir o número de atualizações.
INVALID_ARGUMENT
As seguintes situações podem causar erros INVALID_ARGUMENT:
- Tentativa de confirmar um documento com um valor de campo indexado maior que 1.500 bytes. Esses limites se aplicam à codificação UTF-8 do valor do campo.
- Tentativa de confirmar um documento com valores de campo não indexados maiores que 1.048.487 bytes (1 MiB - 89 bytes). Esse limite é aplicado à soma dos valores de campo em um documento. Por exemplo, quatro campos de 256 KiB cada excedem o limite.
1.500 bytes (indexados) e 1.048.487 bytes (não indexados) são limites para valores de campo. Não é possível exceder esses limites, e eles não são cotas que podem ser ajustadas.
INVALID_ARGUMENT: The value of property field-name is longer than 1500 bytes
ou
INVALID_ARGUMENT: The value of property field_name is longer than 1048487 bytes
Para resolver o problema:
- Para valores de campo indexados, divida o campo em vários campos. Se possível, crie um campo não indexado e mova os dados que não precisam ser indexados para ele.
- Para valores de campo não indexados, divida o campo em vários campos ou implemente a compactação para o valor do campo.