更新时间：2026-01-08 GMT+08:00
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，该次构建内存使用超出了默认大小。
处理方法
方法一：升级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",
"build": "react-scripts build",
"test": "react-scripts test --env=jsdom",
"eject": "react-scripts eject"
} 运行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构建
