EC2实例执行npm run build构建Next.js应用时进程自动终止

1. 确认是否为内存峰值问题 #

别只看实例标称内存，先查系统OOM（内存不足）日志：

dmesg | grep -i oom

如果输出有Out of memory: Killed process相关记录，说明是构建时内存瞬间冲高触发了系统OOM Killer。这种情况下先添加Swap缓解压力：

# 创建4G交换文件
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 设置开机自动挂载
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

2. 检查Node.js版本兼容性 #

Next.js对Node版本有明确要求（比如Next.js 13+需要Node.js ≥16.8），执行node -v确认版本，不匹配的话用nvm切换：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 18
nvm use 18

3. 重置依赖解决缓存损坏问题 #

依赖缓存异常可能导致构建进程崩溃，执行以下命令重置：

rm -rf node_modules package-lock.json
npm cache clean --force
npm install

4. 优化Next.js构建配置 #

修改next.config.js降低构建内存开销：

module.exports = {
  output: 'standalone', // 生成轻量独立部署包，减少构建时内存占用
  experimental: {
    largePageDataBytes: 128 * 1000000, // 放宽大页面数据阈值，避免因数据量过大触发溢出
  },
};

5. 抓取详细构建日志排查 #

如果以上方案无效，执行带日志输出的构建命令，定位具体错误：

npm run build 2>&1 | tee build.log

查看build.log末尾的报错信息，进一步定位问题。

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