NextJS通过Ansible在AWS EC2重复构建出现Zone内存分配失败报错

可行解决方案 #

• 修复Node参数不生效问题
  你的日志中明确提示npm调用的Node实例和执行build脚本的Node实例路径不一致，你配置的--max-old-space-size参数大概率仅传给了npm调用的Node，未实际作用于Next构建进程。可将package.json中的build脚本修改为以下形式，确保参数正确生效：

  "build": "node --max-old-space-size=16384 ./node_modules/next/dist/bin/next build"
  

  执行构建时可额外添加参数保证Node路径优先级：npm run build --scripts-prepend-node-path

• 放开Ansible远程会话的资源配额限制
  你使用的是Windows EC2实例，WinRM远程会话默认存在严格的资源配额限制，这是手动执行正常、Ansible远程执行异常的常见原因。登录实例执行以下命令修改WinRM配置：

  # 单Shell最大内存分配调整为32G
  winrm set winrm/config/winrs @{MaxMemoryPerShellMB="32768"}
  # 单Shell最大进程数调整为100
  winrm set winrm/config/winrs @{MaxProcessesPerShell="100"}
  # 开启远程Shell访问权限
  winrm set winrm/config/winrs @{AllowRemoteShellAccess="true"}
  

• 构建前清理残留缓存
  首次构建正常、重复构建异常大概率和Next构建缓存堆积导致的内存泄漏有关，在Ansible构建步骤前新增以下清理操作：

  # 删除旧的构建缓存目录
  Remove-Item -Recurse -Force .next -ErrorAction SilentlyContinue
  # 清理npm缓存
  npm cache clean --force
  # 可选：删除node_modules重新安装依赖，排除依赖缓存问题
  Remove-Item -Recurse -Force node_modules -ErrorAction SilentlyContinue
  npm install
  

• 检查运行用户的权限限制
  你构建使用的svc.gridsub_dev服务用户可能被Windows组策略限制了单进程最大内存配额，可临时给该用户分配管理员权限测试，如果问题解决则调整对应用户的资源配额策略即可。

• 升级Node.js版本
  你当前使用的Node.js 14.x版本和部分Next.js版本搭配存在已知的构建内存泄漏问题，尤其在重复构建场景下触发概率极高，可升级到Node.js 16.x LTS或你使用的Next.js版本官方推荐的Node版本。

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