如何解决Nuxt项目部署Namecheap时npm run build出现的EAGAIN报错

你遇到的EAGAIN报错核心是共享主机资源配额不足，加上Node版本不匹配共同导致的：

• 系统返回EAGAIN错误代表执行spawn创建新Node子进程时，操作系统无法分配足够资源。Namecheap等平台的共享cPanel主机对单个用户的进程数、内存上限有严格限制，而Nuxt默认构建会启动多个jest-worker子进程并行编译，超出配额就触发该错误。
• 日志中存在Node版本不匹配问题：build报错调用的是Node 12路径，dev运行日志使用的是Node 14环境，版本不一致会导致依赖编译异常，额外增加资源消耗。

按以下步骤逐一排查处理即可：

1. 统一Node版本
   先在cPanel站点配置中固定Node版本（推荐和本地开发用的版本保持一致），删除旧的依赖文件重新安装：

rm -rf node_modules package-lock.json
npm install

2. 限制Nuxt构建并行进程数
   关闭并行编译减少子进程创建，两种方案二选一即可：

• 临时在构建命令中加参数：

NUXT_JEST_WORKERS=1 NODE_OPTIONS=--max-old-space-size=512 npm run build

• 直接修改nuxt.config.js配置永久生效：

export default {
  build: {
    // 关闭并行构建
    parallel: false,
    // 关闭缓存减少资源占用
    cache: false,
    // 关闭代码压缩的并行处理
    terser: {
      parallel: false
    }
  }
}

3. 释放冗余进程资源
   执行命令杀掉当前用户下闲置的Node进程，释放配额后再执行构建：

pkill node

4. 绕开服务器构建（可选）
   如果上述方案都受限于主机配额无法生效，可以本地完成npm run build后，将.nuxt文件夹、package.json、nuxt.config.js上传到服务器，只在服务器执行npm install --production安装生产依赖即可，无需在服务器端执行构建操作。

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