文档首页/ 编译构建 CodeArts Build/ 常见问题/ Npm构建/ 执行Npm构建时，报错提示JavaScript heap out of memory
更新时间：2025-07-30 GMT+08:00
查看PDF
分享

执行Npm构建时，报错提示JavaScript heap out of memory

问题现象

执行Npm构建任务时，日志报如下异常信息：

FATAL ERROR：CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory.

原因分析

Nodejs运行时使用的内存有大小限制，64位系统约为1.4GB，32位系统约为0.7GB，本次构建内存使用超出了默认大小。

处理方法

方法一：参考配置NPM构建，通过设置工具版本，升级nodejs版本。

方法二：启动Node时设置“--max_old_space_size”或“--max_new_space_size”参数来调整内存大小的使用限制。

node --max_old_space_size=1700 test.js // 单位为MB 修改老生代内存限制
node --max_new_space_size=1024 test.js // 单位为KB 修改新生代内存限制

针对前端三大框架的解决方法如下：

框架类型

解决方法

Vue

需要修改“package.json”文件中“build”属性值，在命令中加入带参数的node命令即可，例如：

"build": "node --max_old_space_size=4096  ./node_modules/vite/bin/vite.js build"

或

"build": "node --max_old_space_size=4096 ./node_modules/@vue/cli-service/bin/vue-cli-service.js build"

React

“package.json”里面“scripts”字段的内容如下：

"scripts": {
"start": "react-scripts start", #启动开发服务器，运行React应用
"build": "react-scripts build", #构建生产环境的代码
"test": "react-scripts test --env=jsdom", #运行测试脚本
"eject": "react-scripts eject" #将项目从create-react-app脚手架中解耦
}

运行npm run build时，实际执行的代码是react-scripts build，项目根目录下“node_modules”文件夹，找到.bin目录并打开，找到并打开“react-scripts”文件，将--max_old_space_size=4096代码写在#!/usr/bin/env node后。

#!/usr/bin/env node --max_old_space_size=4096

Angular

“package.json”里的“scripts”字段的内容如下：

"scripts": {
"ng": "ng",
"start": "ng serve",
"build": "ng build",
"test": "ng test",
"lint": "ng lint",
"e2e": "ng e2e"
}

这里的ng命令和React一样，在项目根目录“node_modules”文件夹下的.bin目录里面存在名为ng的文件，修改该文件的首行。

#!/usr/bin/env  node --max_old_space_size=4096
父主题： Npm构建

相关文档