Informazioni sui codici di errore
Questa pagina elenca i codici di errore che potresti riscontrare e fornisce suggerimenti su come correggerli.
DEADLINE_EXCEEDED
I seguenti fattori possono aumentare gli errori DEADLINE_EXCEEDED
:
- Un aumento della latenza ha causato un tempo di completamento dell'operazione superiore alla scadenza (60 secondi per impostazione predefinita).
DEADLINE_EXCEEDED A deadline was exceeded on the server.
Per risolvere il problema, consulta la guida alla risoluzione dei problemi di latenza.
ABORTED
Le seguenti situazioni possono aumentare gli errori ABORTED
:
- Un documento che riceve troppi aggiornamenti al secondo.
- Concorrenza dovuta a transazioni sovrapposte.
- Aumenti di traffico che superano la regola 500-50-5 o che presentano hot spot.
ABORTED Too much contention on these datastore entities. Please try again.
Oppure
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.
Per risolvere il problema:
- In caso di aumenti rapidi del traffico, Firestore tenta di eseguire la scalabilità automatica per soddisfare la domanda in aumento. Quando Firestore viene scalato, la latenza inizia a diminuire.
- Gli hotspot limitano la capacità di Firestore di aumentare le dimensioni. Consulta la sezione Progettazione per la scalabilità per identificare gli hotspot.
- Esamina la contesa dei dati nelle transazioni e il tuo utilizzo delle transazioni.
- Riduci la frequenza di scrittura dei singoli documenti.
RESOURCE_EXHAUSTED
Le seguenti situazioni possono causare errori RESOURCE_EXHAUSTED
:
- Hai superato la quota del livello gratuito e la fatturazione non è attivata per il tuo progetto.
RESOURCE_EXHAUSTED Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.
Per risolvere il problema:
- Attendi il ripristino giornaliero della quota del livello gratuito o attiva la fatturazione per il tuo progetto.
INVALID_ARGUMENT
Le seguenti situazioni possono causare errori INVALID_ARGUMENT
:
- Tentativo di commit di un documento con un valore di campo indicizzato superiore a 1500 byte. Questi limiti si applicano alla codifica UTF-8 del valore del campo.
- Tentativo di commit di un documento con valori di campo non indicizzati superiori a 1.048.487 byte (1 MiB - 89 byte). Questo limite si applica alla somma degli valori di campo in un documento. Ad esempio, quattro campi di 256 KiB ciascuno superano il limite.
1500 byte (indicizzati) e 1.048.487 byte (non indicizzati) sono limiti per i valori di campo. Non puoi superare questi limiti e non si tratta di quote che possono essere aggiustate.
INVALID_ARGUMENT: The value of property field-name is longer than 1500 bytes
o
INVALID_ARGUMENT: The value of property field_name is longer than 1048487 bytes
Per risolvere il problema:
- Per i valori dei campi indicizzati, suddividi il campo in più campi. Se possibile, crea un campo non indicizzato e sposta i dati che non devono essere indicizzati nel campo non indicizzato.
- Per i valori di campo non indicizzati, suddividi il campo in più campi o implementa la compressione per il valore del campo.