Windows环境下Next.js应用后台运行（PM2配置求助）

1. 正确安装PM2（Windows环境） #

• 确认已安装Node.js，打开管理员权限的PowerShell/CMD，执行全局安装命令：
  npm install pm2 -g
• 如果执行pm2命令提示"找不到命令"，手动将Node.js全局bin目录（默认路径：C:\Users\<你的用户名>\AppData\Roaming\npm）添加到系统环境变量的Path中，重启终端后重试。

2. 配置Next.js专属PM2启动文件 #

在Next.js项目根目录创建ecosystem.config.js，粘贴以下配置（可根据需求调整）：

module.exports = {
  apps: [
    {
      name: "next-production-app", // 自定义应用名称
      script: "node_modules/next/dist/bin/next",
      args: "start -p 3000", // 指定运行端口，按需修改
      cwd: "./", // 项目根目录路径
      instances: 1, // Windows环境建议设为1，多实例易引发端口冲突
      autorestart: true, // 应用崩溃后自动重启
      watch: false, // 生产环境关闭文件监听，避免意外重启
      env: {
        NODE_ENV: "production"
      }
    }
  ]
};

注意：先执行npm run build完成生产环境编译，PM2仅负责启动编译后的应用。

3. 启动应用与常见报错处理 #

• 编译完成后，在项目根目录执行启动命令：
  pm2 start ecosystem.config.js
• 常见问题修复：
  • "script not found"报错：若Next.js版本差异导致启动脚本路径不对，可将script改为"npm"，args改为"run start"，用npm命令间接启动。
  • 权限不足：必须用管理员权限打开终端执行PM2命令，避免文件/端口访问受限。
  • 端口占用：修改配置中-p后的端口号，或先执行pm2 delete <应用名称>停止旧进程再启动。

4. 设置Windows开机自启 #

• 保存当前PM2进程列表：pm2 save
• 生成开机自启脚本：pm2 startup windows，按终端提示完成权限验证操作。
• 重启服务器，验证应用是否自动启动。

5. 日常进程管理命令 #

• 查看实时日志：pm2 logs <应用名称>
• 停止应用：pm2 stop <应用名称>
• 重启应用：pm2 restart <应用名称>
• 查看所有运行进程：pm2 list

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