Informazioni sui codici di errore
Questa pagina elenca i codici di errore che potresti riscontrare e fornisce suggerimenti su come risolverli.
DEADLINE_EXCEEDED
I seguenti fattori possono aumentare gli errori DEADLINE_EXCEEDED:
- Un aumento della latenza ha fatto sì che un'operazione richiedesse più tempo del previsto (60 secondi per impostazione predefinita) per essere completata.
DEADLINE_EXCEEDED A deadline was exceeded on the server.
Per risolvere il problema, consulta la guida alla risoluzione dei problemi di latenza.
INTERROTTO
Le seguenti situazioni possono aumentare gli errori ABORTED:
- Un documento che riceve troppi aggiornamenti al secondo.
- Contesa dovuta a transazioni sovrapposte.
- Aumenti del traffico che superano la regola 500-50-5 o che incontrano hotspot.
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 rapidi aumenti del traffico, Firestore tenta di scalare automaticamente per soddisfare la maggiore domanda. Quando Firestore viene scalato, la latenza inizia a diminuire.
- Gli hotspot limitano la capacità di scalabilità di Firestore. 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 per i 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.
Aumenti di traffico che non seguono le best practice
RESOURCE_EXHAUSTED Some resource has been exhausted, perhaps a per-user quota.
Oppure
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.
Per risolvere il problema:
Se hai raggiunto la quota del livello gratuito, attendi il ripristino giornaliero della quota del livello gratuito o attiva la fatturazione per il tuo progetto.
In caso di rapidi aumenti del traffico, Firestore tenta di scalare automaticamente per soddisfare la maggiore domanda. Quando Firestore scala, gli errori potrebbero diminuire.
Gli hotspot limitano la capacità di scalabilità di Firestore. Consulta la sezione Progettazione per la scalabilità per identificare i punti critici.
Per le query degli ascoltatori in tempo reale, assicurati che non siano inutilmente ampie. Utilizza i filtri per ridurre il numero di aggiornamenti.
INVALID_ARGUMENT
Le seguenti situazioni possono causare errori INVALID_ARGUMENT:
- Tentativo di eseguire il commit di un documento con un valore di campo indicizzato superiore a 1500 byte. Questo limite si applica alla codifica UTF-8 del valore del campo.
- Tentativo di eseguire il 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 dei valori dei campi in un documento. Ad esempio, quattro campi da 256 KiB ciascuno superano il limite.
1500 byte (indicizzati) e 1.048.487 byte (non indicizzati) sono i limiti per i valori dei campi. Non puoi superare questi limiti e non sono quote che possono essere modificate.
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, dividi il campo in più campi. Se possibile, crea un campo non indicizzato e sposta i dati che non devono essere indicizzati in questo campo.
- Per i valori dei campi non indicizzati, dividi il campo in più campi o implementa la compressione per il valore del campo.