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