直接调大V8堆内存上限能缓解“JavaScript heap out of memory”错误，但非根治方案；最常用参数是--max-old-space-size，用于设置老生代堆上限，默认64位约1.4GB，需配合process.memoryUsage()验证及内存泄漏排查。
直接调大 V8 堆内存上限能缓解“JavaScript heap out of memory”错误，但不是万能解药——它只是推迟溢出时间，前提是代码本身没有持续增长的内存占用。核心在于用对参数、设合理值、配合诊断手段。
明确要调哪个参数
--max-old-space-size 是最常用且有效的开关，它只影响老生代（Old Space）堆上限，也就是长期存活对象所在的区域。默认 64 位 Node.js 约 1.4 GB，调高后 GC 触发频率下降，适合缓存、大数组、源码解析等场景。注意：它不扩大新生代，也不改变物理内存实际分配行为，只是放宽 V8 报错阈值。
正确设置方式
- 命令行启动时加在 node 后、脚本前：
node --max-old-space-size=4096 app.js（单位 MB，4096 = 4GB） - 通过环境变量更稳妥：
NODE_OPTIONS="--max-old-space-size=4096" node app.js - package.json 中 scripts 写法：
"start": "NODE_OPTIONS=\"--max-old-space-size=4096\" node app.js" - Docker 场景下必须小于容器内存限制，建议预留 20% 余量，比如
--memory=6g就别设--max-old-space-size=6144
验证是否生效
光设了不等于起效。运行时检查最可靠：
- 打印当前堆信息：
console.log(process.memoryUsage())，关注heapTotal是否接近你设的值（会有小幅浮动） - 启动时加
--trace-gc参数，看日志里 GC 触发点是否延后 - 用
process.memoryUsage().heapUsed / process.memoryUsage().heapTotal计算使用率，对比调参前后变化趋势
别跳过根本排查
调参是临时止痛，不是根治。如果堆使用率持续单向爬升，大概率存在内存泄漏：
立即学习“Java免费学习笔记（深入）”；
- 用 Chrome DevTools 连接 Node.js 进程（
node --inspect app.js），录制 Heap Snapshot，筛选 Detached DOM 或 Closure 持有大量数据 - 检查全局缓存是否无清理机制、事件监听器未注销、闭包意外保留大数据引用
- 批量操作改用流式处理（如 fs.createReadStream + pipe）、分块读取（chunk size 控制在几 MB 内）
- 避免
JSON.parse一次性加载超大文件，改用 JSONStream 或 sax 解析
