执行Webpack构建时--max-old-space-size设置不生效问题排查

运行Webpack构建项目时遇到javascript heap out of memory error错误，尝试为执行Webpack的Node进程分配4GB内存。package.json的scripts配置如下：

"scripts": {
    "build:prod": "node --max-old-space-size=4096 webpack -p --config webpack/webpack.config.prod.js"
}

执行npm run build:prod后，通过以下代码打印堆内存统计信息：

const v8 = require('v8');

const heapStats = v8.getHeapStatistics();
console.log(heapStats);

得到结果：

{ total_heap_size: 6537216,
  total_heap_size_executable: 1048576,
  total_physical_size: 5222208,
  total_available_size: 1520740616,
  used_heap_size: 4015776,
  heap_size_limit: 1526909922,
  malloced_memory: 8192,
  peak_malloced_memory: 421336,
  does_zap_garbage: 0 }

其中heap_size_limit仍显示约1.5GB，请问操作哪里出错了？

核心问题：内存参数未作用于实际构建的Node进程 #

你当前的写法是给启动webpack-cli的父Node进程设置了内存限制，但新版webpack（如webpack 4及以上）的cli会自动fork一个子进程执行构建任务，父进程的内存参数不会传递给子进程，所以实际构建进程还是用默认的约1.5GB内存限制。

具体解决办法 #

• 方法一：通过NODE_OPTIONS环境变量传递参数
  让所有衍生的Node进程都继承内存配置，修改scripts如下：

  "scripts": {
      "build:prod": "NODE_OPTIONS='--max-old-space-size=4096' webpack -p --config webpack/webpack.config.prod.js"
  }
  

  Windows环境下需把单引号换成双引号：

  "scripts": {
      "build:prod": "NODE_OPTIONS=\"--max-old-space-size=4096\" webpack -p --config webpack/webpack.config.prod.js"
  }
  

• 方法二：直接给webpack-cli传递参数
  新版webpack-cli支持直接接收Node的内存参数，写法如下：

  "scripts": {
      "build:prod": "webpack -p --config webpack/webpack.config.prod.js --max-old-space-size=4096"
  }
  

• 验证参数是否生效
  把打印堆内存的代码放到你的webpack配置文件（webpack.config.prod.js）最顶部，这样就能获取到实际构建进程的内存统计，而不是父进程的信息。

• 额外排查点

  • 如果你用全局安装的webpack，可能需要确保参数传递路径正确，优先使用项目本地的webpack（通过npx webpack或者npm scripts调用）。
  • 检查Node版本，建议升级到LTS版本，旧版本Node对大内存限制的支持可能存在问题。

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