如何使用Yarn以PM2集群模式启动Next.js应用？启动崩溃排查

问题分析 #

你遇到的核心矛盾很明确：PM2的cluster模式会把启动目标当作Node.js模块来执行，但yarn本身是bash脚本，并非Node.js文件。当Node尝试解析yarn的bash代码时，自然会抛出语法错误（SyntaxError: missing ) after argument list）。而fork模式下PM2是直接启动子进程执行bash命令，所以用npm/yarn能正常运行——这也是为什么你fork模式没问题，cluster模式就崩了的原因。

解决方案 #

方案1：直接启动Next.js的Node入口文件（最直接）

跳过yarn/npm的封装，直接指向Next.js的Node启动脚本，让PM2的cluster模式能正确识别并管理Node实例：

pm2 start ./node_modules/next/dist/bin/next -i 2 --name "frontend" -- start

方案2：用PM2生态配置文件管理（推荐）

创建ecosystem.config.js配置文件，把启动规则写得更清晰，后续维护也方便：

module.exports = {
  apps: [
    {
      name: 'frontend',
      script: './node_modules/next/dist/bin/next',
      args: 'start',
      instances: 2, // 指定集群实例数量
      exec_mode: 'cluster',
      env: {
        NODE_ENV: 'production'
      }
    }
  ]
};

然后执行启动命令即可：

pm2 start ecosystem.config.js

方案3：通过Yarn间接启动（适配cluster模式，不推荐）

如果你坚持要用yarn命令启动，可以指定PM2用bash解释器执行，但这种方式本质是启动多个bash进程再分别拉起Node，并非真正的Node集群（无法利用PM2对Node进程的精细化管理）：

pm2 start yarn -i 2 --name "frontend" --interpreter bash -- start

验证方法 #

启动后执行pm2 status查看实例状态，正常情况下会保持online状态不再崩溃。也可以用pm2 logs frontend查看实时日志，确认没有语法错误输出。

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