使用PM2启动Next.js项目报错，npm start正常求解决方法

1. 先确认PM2启动命令是否正确 #

• 别直接用PM2跑next dev，这是开发模式命令，生产环境得用对应npm run start的脚本。正确的PM2启动方式有两种：
  • 命令行直接启动：pm2 start npm --name "你的项目名" -- run start
  • 用配置文件（新建ecosystem.config.js）：

module.exports = {
  apps: [{
    name: 'next-app',
    script: 'npm',
    args: 'run start',
    env: {
      NODE_ENV: 'production'
    }
  }]
};

然后执行pm2 start ecosystem.config.js

2. 核对环境变量和工作目录 #

• npm start会自动加载项目根目录的.env.production，但PM2可能没正确读取。先检查PM2的工作目录：pm2 show 你的项目名，查看cwd字段是否为项目根目录，若不是，启动时添加--cwd /你的项目绝对路径参数。
• 也可以直接在PM2配置里手动指定环境变量，避免遗漏关键配置。

3. 检查Node.js版本是否一致 #

• 终端使用的Node版本和PM2调用的版本可能不一致，引发依赖兼容性问题。分别执行以下命令核对：
  • 终端Node版本：node -v
  • PM2使用的Node版本：pm2 env 你的项目名，查找NODE_VERSION字段
• 版本不匹配时，要么切换终端的Node版本，要么启动PM2时指定Node路径，示例：pm2 start npm --name "next-app" --interpreter /你本地的node路径/bin/node -- run start

4. 确认项目已完成生产构建 #

• 生产环境启动必须先执行npm run build生成.next目录，未构建就启动PM2大概率报错。先检查项目根目录是否存在.next文件夹，若没有，先执行npm run build再启动PM2。

5. 查看PM2日志定位具体错误 #

• PM2的日志存储在~/.pm2/logs/目录下，查看对应项目的错误日志：cat ~/.pm2/logs/你的项目名-error.log，日志里会明确报错原因（比如端口占用、依赖缺失、环境变量未定义等），针对性解决即可。

6. 排查端口占用问题 #

• 如果日志提示端口被占用，用lsof -i :你的项目端口（Linux/macOS）或netstat -ano | findstr :你的项目端口（Windows）找到占用进程，杀掉进程后重新启动PM2。

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