DigitalOcean上Node应用加载时重启：JavaScript堆内存溢出问题

已知信息 #

• Node版本：12.22.12
• 服务器内存：8GB
• 已做配置：
  • 设置NODE_OPTIONS="--max-old-space-size=12288"（12GB堆内存上限）
  • 添加环境变量GENERATE_SOURCEMAP=false
• 异常现象：本地仅调大堆内存即可解决JavaScript heap out of memory错误，但服务器上应用占用约2.5GB内存后就触发重启，仍报相同错误

解决建议 #

1. 修正堆内存上限的不合理配置 #

服务器总内存仅8GB，却设置12GB的堆内存上限，会导致Node进程试图申请超出系统可用的内存，触发系统的OOM Killer直接终止进程（表现为内存没到设置的上限就重启）。建议将堆内存上限调整为合理值，比如4GB（--max-old-space-size=4096），预留足够内存给系统和其他进程。

2. 检查PM2的内存重启阈值 #

PM2默认可能设置了内存上限阈值，当进程内存占用达到该值时自动重启。可以通过以下命令查看当前配置：

pm2 show <你的应用名称>

如果存在max_memory_restart配置，建议调整或移除该限制，避免误触发重启。可在PM2的生态系统文件（如ecosystem.config.js）中修改：

module.exports = {
  apps: [{
    name: "your-app",
    script: "app.js",
    max_memory_restart: "4G", // 根据实际情况调整，或注释掉取消限制
    env: {
      NODE_OPTIONS: "--max-old-space-size=4096",
      GENERATE_SOURCEMAP: "false"
    }
  }]
};

更新配置后执行pm2 reload ecosystem.config.js生效。

3. 排查应用内存泄漏问题 #

若应用存在内存泄漏，即使调整堆内存也会逐渐耗尽内存。可以用这些方法排查：

• 启动应用时添加--inspect参数，通过Chrome DevTools的Memory面板分析内存快照：

  NODE_OPTIONS="--max-old-space-size=4096 --inspect" pm2 start app.js
  

• 使用pm2 monit实时监控进程内存变化，观察是否有持续增长的趋势。
• 针对Node.js 12版本，可使用clinic.js工具（需全局安装）生成内存分析报告：

  npm install -g clinic
  clinic heapprofiler -- node app.js
  

4. 验证环境变量是否正确生效 #

服务器上可能存在环境变量未正确加载的情况，可通过以下方式确认：

• 在应用代码中添加打印逻辑：

  console.log('NODE_OPTIONS:', process.env.NODE_OPTIONS);
  console.log('GENERATE_SOURCEMAP:', process.env.GENERATE_SOURCEMAP);
  

• 通过PM2查看进程环境变量：

  pm2 env <你的应用名称>
  

确保NODE_OPTIONS和GENERATE_SOURCEMAP已正确设置。

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