使用PM2部署Next.js应用时报错：缺少必填参数'file|environment'

1. 修复deploy命令格式 #

这个错误是因为pm2 deploy命令必须指定环境名称（比如你配置里的production），如果配置文件不是默认的ecosystem.config.js，还要额外指定配置文件路径。

正确的命令写法：

# 配置文件为默认的ecosystem.config.js时
pm2 deploy production

# 明确指定配置文件路径的写法
pm2 deploy ecosystem.config.js production

首次部署前，需要先执行setup命令初始化服务器上的目录和仓库：

pm2 deploy production setup

2. 修正ecosystem.config.js配置问题 #

你的配置里还有几个需要调整的细节：

• key字段指向错误：应该填SSH私钥路径，不是公钥。PM2需要用私钥完成SSH认证，公钥是放在服务器授权列表里的：

  key: '~/.ssh/id_ed25519', // 去掉.pub后缀
  

• pre-deploy命令适配首次部署：pre-deploy是在服务器上执行的命令，首次部署时目标路径还没有git仓库，直接执行git命令会报错。可以调整为判断仓库存在才执行：

  'pre-deploy': '[ -d .git ] && git fetch --all && git reset --hard origin/branch-12 || echo "首次部署跳过pre-deploy"',
  

• post-deploy脚本权限与路径：确保脚本有执行权限，且路径正确，修改为：

  'post-deploy': 'chmod +x ./nextjs-pm2-deploy.sh && sh ./nextjs-pm2-deploy.sh',
  

3. 完整修正后的配置示例 #

module.exports = {
    apps: [
        {
            name: 'next-app',
            script: 'npm run start',
            env: {
                NODE_ENV: 'development'
            },
            env_production: {
                NODE_ENV: 'production'
            }
        }
    ],
    deploy: {
        production: {
            user: 'ubuntu',
            host: ["123.12.12.123"],
            key: '~/.ssh/id_ed25519',
            ssh_options: 'ForwardAgent=yes',
            ref: 'origin/branch-12',
            repo: 'git@github.com:my-username/my-repo.git',
            path: '/var/www/my-project/',
            'pre-deploy': '[ -d .git ] && git fetch --all && git reset --hard origin/branch-12 || echo "首次部署跳过pre-deploy"',
            'post-deploy': 'chmod +x ./nextjs-pm2-deploy.sh && sh ./nextjs-pm2-deploy.sh'
        }
    }
};

4. 标准部署流程 #

1. 先执行setup初始化服务器环境：pm2 deploy production setup
2. 再执行部署命令：pm2 deploy production

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