NestJS应用设置--max-old-space-size后堆内存未变化，求排查

你的启动命令参数位置错了，Node.js的运行时配置参数（比如--max-old-space-size）必须放在要执行的脚本文件前面，否则会被当成脚本自身的命令行参数，根本没传给V8引擎。

正确的启动命令 #

把参数移到dist/main前面：

node --max-old-space-size=16384 dist/main

验证参数是否生效的正确方式 #

heapTotal是当前V8已分配的堆内存大小，不是你设置的最大限制，所以光看它看不出参数是否生效。你可以用以下两种方式验证：

1. 在NestJS代码里打印堆内存上限
   在main.ts里添加这段代码：

import * as v8 from 'node:v8';

// 启动后打印最大堆内存限制（转换为MB）
console.log('V8最大堆内存限制:', v8.getHeapStatistics().heap_size_limit / (1024 * 1024), 'MB');

启动后如果输出接近16384MB，说明参数生效了。

2. 终端直接验证
   在终端执行这条命令，直接查看V8的堆内存配置：

node --max-old-space-size=16384 -e "console.log(require('v8').getHeapStatistics().heap_size_limit / 1024 / 1024)"

正常会输出约16384的数值。

其他可能的坑 #

如果你是通过npm run start这类脚本启动的，要确保在package.json里把参数加到Node命令里，比如：

{
  "scripts": {
    "start": "node --max-old-space-size=16384 dist/main"
  }
}

如果用了PM2等进程管理器，需要在配置文件的node_args字段里设置这个参数，而不是加到启动命令的脚本后面。

内容的提问来源于stack exchange，提问作者Ankur