jenkins构建报错Reached heap limit Allocation failed - JavaScript heap out of memory

### Jenkins 构建时出现 `Reached heap limit Allocation failed - JavaScript heap out of memory` 的解决方案 在 Jenkins 构建过程中，如果前端项目（如 Vue.js、React 等）在打包阶段出现 `Reached heap limit Allocation failed - JavaScript heap out of memory` 错误，通常意味着 Node.js 的默认内存限制不足以支撑当前的构建任务。 #### 增加 Node.js 内存限制 可以通过在构建命令中添加 `--max-old-space-size` 参数来扩展 Node.js 进程的内存上限。例如，在 `package.json` 的 `scripts` 中修改构建命令如下： ```json "scripts": { "build": "node --max-old-space-size=4096 node_modules/@vue/cli-service/bin/vue-cli-service.js build", "serve": "node --max-old-space-size=4096 node_modules/@vue/cli-service/bin/vue-cli-service.js serve" } ``` 该参数的值（如 `4096`）表示分配的最大内存为 4GB。根据项目的复杂程度，可以适当增加到 6144 或更高[^4]。 #### 使用 `cross-env` 和 `increase-memory-limit` 工具 为确保构建命令在不同操作系统中都能生效，可以使用 `cross-env` 设置环境变量，并结合 `increase-memory-limit` 来增强内存限制： ```bash npm install --save-dev cross-env increase-memory-limit ``` 然后在 `package.json` 中配置： ```json "scripts": { "build": "cross-env NODE_OPTIONS=--max-old-space-size=8192 vue-cli-service build" } ``` 该方式适用于 Vue 3 项目，也适用于其他基于 Webpack 或 Vite 的前端框架[^2]。 #### Jenkins Pipeline 配置建议 在 Jenkins 的 `Jenkinsfile` 或构建脚本中执行构建命令时，确保使用的是修改后的脚本命令。例如： ```groovy pipeline { agent any stages { stage('Build') { steps { sh 'npm run build' } } } } ``` 确保 Jenkins 所在服务器的 Node.js 环境支持大内存操作，并在必要时升级 Node.js 到最新 LTS 版本，以获得更好的内存管理和性能优化[^1]。 #### 优化构建过程 除了增加内存限制，还可以通过以下方式优化构建流程以减少内存占用： - **减少依赖项**：定期清理不必要的 npm 包。 - **启用 Webpack 缓存**：在 Webpack 配置中启用缓存机制，减少重复构建的资源消耗。 - **使用增量构建**：在开发环境中启用增量构建，避免每次全量打包。 --- ###