node · npm
報錯原文
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
這是什麼意思
V8 的堆到了上限，node 自己放棄了——不是作業系統把它殺了，是 node 判斷沒法再長下去而停住。原因是一次大的型別檢查或打包、在大專案上開著 source map 建置，或者像把所有東西都往陣列裡堆這樣的洩漏程式碼。export NODE_OPTIONS=--max-old-space-size=4096 把上限提到 4 GB，往往就夠了，但機器得真有這麼多記憶體；如果容器的限制更低，這次換成作業系統來殺行程，表現為結束碼 137。如果這個數字得一次次往上加，原因就是洩漏，而不是上限。
怎麼修
export NODE_OPTIONS=--max-old-space-size=4096- 來自
- node
- npm
- 20
npm 的原因寫在第一行 code XXXX 裡，而不是最後那六行 npm ERR!；如果失敗來自相依樹或原生編譯而不是你自己的程式碼，刪掉 node_modules 重新安裝就能解決一半。
怎麼讀報錯
- 從第一行往下讀。越往下越是工具內部的事，起因通常寫在最上面。
- 有檔名和行號就從那裡查——不是堆疊最上面那一格，而是最上面那條提到你自己寫的檔案的行。
- 把報錯原文照樣去搜，但先去掉你自己的路徑和變數名，正是那些讓搜尋比對不上。
- 同一種情況在不同版本裡措辭不同。結果不對頭，就把版本號一起加進查詢。
- 貼上修法之前，先確認它會丟掉什麼。這裡面有些是不能收回的。
常見問題
Q. “FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory” 是什麼意思？
V8 的堆到了上限，node 自己放棄了——不是作業系統把它殺了，是 node 判斷沒法再長下去而停住。原因是一次大的型別檢查或打包、在大專案上開著 source map 建置，或者像把所有東西都往陣列裡堆這樣的洩漏程式碼。export NODE_OPTIONS=--max-old-space-size=4096 把上限提到 4 GB，往往就夠了，但機器得真有這麼多記憶體；如果容器的限制更低，這次換成作業系統來殺行程，表現為結束碼 137。如果這個數字得一次次往上加，原因就是洩漏，而不是上限。
Q. 怎麼修？
export NODE_OPTIONS=--max-old-space-size=4096 —— 執行前先看上面的說明，確認這條命令會丟掉什麼。
Q. 這是哪個工具報的？
node。它屬於npm，報錯原文有 13 個詞。
相關報錯
npm ERR! code ELIFECYCLEnpmError: error:0308010C:digital envelope routines::unsupportednode 17+npm WARN EBADENGINE Unsupported enginenpmzsh: command not found: tscshellnpm ERR! ERESOLVE unable to resolve dependency treenpmnpm ERR! Conflicting peer dependency: react@18.3.1npmnpm WARN react-dom@17.0.2 requires a peer of react@17.0.2 but none is installed.npm 6npm WARN deprecated request@2.88.2: request has been deprecatednpm