AWS EC2 Node.js出现JavaScript堆内存溢出故障 求助定位根本原因

核心报错信息：Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory

1. 确认--max-old-space-size参数是否实际生效 #

• 执行ps aux | grep node查看运行中的Node进程启动参数，确认--max-old-space-size=10240是否正确附加在进程命令后。大部分该类问题都是PM2配置的参数未正确传递导致的：比如配置写在了错误的字段下、ecosystem.config.js存在语法错误、修改配置后未执行pm2 reload 服务名 --update-env让新配置生效。
• 注意参数规范写法为双中划线加短横线分隔，部分旧版本Node.js不兼容下划线写法，优先使用--max-old-space-size而非--max_old_space_size避免兼容性问题。

2. 排查AWS EC2实例系统层面限制 #

• 执行free -h确认实例实际可用总内存，若你使用的实例规格总内存低于10GB（如t2.medium仅4GB内存），Node进程可使用的内存上限会以系统实际可用内存为准，不会达到你配置的10GB。
• 若实例未配置swap交换分区，内存占满后会直接触发系统OOM Killer强制终止进程，该操作是系统内核发起的，不会被Node.js代码层面的异常捕获逻辑捕获。可查看系统日志/var/log/syslog（Debian/Ubuntu）或/var/log/messages（CentOS/RHEL），搜索oom-killer关键词验证是否为系统主动杀进程。
• 你提供的ulimit配置无异常，不需要调整。

3. 核查PM2配置问题 #

• 若你开启了PM2多进程模式，每个Node进程的--max-old-space-size是独立计算的，比如启动10个进程每个配置10GB，总内存需求会远超实例实际负载，很快触发系统OOM。
• 检查PM2配置中是否设置了max_memory_restart参数，若该值错误配置为1GB，进程内存占用到1GB时就会被PM2强制终止，若配置的重启逻辑异常就会导致服务完全崩溃需要重启服务器恢复。

4. 验证Node.js版本兼容性 #

• 若你使用的是32位版本的Node.js，堆内存上限默认最高为1GB，无论怎么配置--max-old-space-size都不会生效，执行node -p "process.arch"确认输出为x64即可排除该问题。
• 部分Node.js非LTS小版本存在内存统计bug，建议升级到当前大版本的最新LTS版本验证故障是否消失。

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