node · npm
メッセージ
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
何を意味するか
V8 のヒープが上限に達し、node が自ら諦めたという意味です。OS が殺したのではなく、node がこれ以上増やせないと判断して止まりました。大きなプロジェクトの型検査や束ね、ソースマップを入れたビルド、あるいは何でも配列に溜め込むような漏れのあるコードが原因です。export NODE_OPTIONS=--max-old-space-size=4096 で上限を 4 GB まで上げれば多くは通りますが、機械に実際その分の記憶が要り、コンテナの制限がより低ければ今度は OS が処理を殺し、終了コード 137 として現れます。数字を上げ続けなければならないなら、原因は上限ではなく漏れです。
直しかた
export NODE_OPTIONS=--max-old-space-size=4096- 出す道具
- node
- npm
- 20
npm では原因は最後の六行ではなく最初の code XXXX の一行に書かれており、失敗が自分のコードではなく依存関係の木やネイティブビルドから来ている場合は、node_modules を消して入れ直すだけで半分は解けます。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory はどういう意味ですか。
V8 のヒープが上限に達し、node が自ら諦めたという意味です。OS が殺したのではなく、node がこれ以上増やせないと判断して止まりました。大きなプロジェクトの型検査や束ね、ソースマップを入れたビルド、あるいは何でも配列に溜め込むような漏れのあるコードが原因です。export NODE_OPTIONS=--max-old-space-size=4096 で上限を 4 GB まで上げれば多くは通りますが、機械に実際その分の記憶が要り、コンテナの制限がより低ければ今度は OS が処理を殺し、終了コード 137 として現れます。数字を上げ続けなければならないなら、原因は上限ではなく漏れです。
Q. どう直しますか。
export NODE_OPTIONS=--max-old-space-size=4096 — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
node です。npmの仲間で、文句は13語です。