node · npm
A mensagem
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
O que significa
O heap do V8 bateu no teto e o node desistiu por conta própria: o sistema operacional não o matou, o node concluiu que não podia crescer mais e parou. A causa é uma verificação de tipos ou um empacotamento grande, uma compilação com source maps num projeto grande, ou código com vazamento como acumular tudo num array. export NODE_OPTIONS=--max-old-space-size=4096 sobe o teto para 4 GB e muitas vezes basta, mas a máquina precisa ter essa RAM de fato, e se o limite de um contêiner for menor o sistema operacional mata o processo, o que aparece como código de saída 137. Se o número precisa crescer sempre, a causa é um vazamento e não o limite.
A correção
export NODE_OPTIONS=--max-old-space-size=4096- Impresso por
- node
- npm
- 20
No npm a causa está na primeira linha code XXXX e não nas seis últimas linhas npm ERR!, e quando a falha vem da árvore de dependências ou de uma compilação nativa em vez do seu código, apagar node_modules e instalar de novo resolve metade dos casos.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory”?
O heap do V8 bateu no teto e o node desistiu por conta própria: o sistema operacional não o matou, o node concluiu que não podia crescer mais e parou. A causa é uma verificação de tipos ou um empacotamento grande, uma compilação com source maps num projeto grande, ou código com vazamento como acumular tudo num array. export NODE_OPTIONS=--max-old-space-size=4096 sobe o teto para 4 GB e muitas vezes basta, mas a máquina precisa ter essa RAM de fato, e se o limite de um contêiner for menor o sistema operacional mata o processo, o que aparece como código de saída 137. Se o número precisa crescer sempre, a causa é um vazamento e não o limite.
Q. Como corrigir?
export NODE_OPTIONS=--max-old-space-size=4096 — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
node. Fica em npm e a mensagem tem 13 palavras.