Github Actions执行pm2 restart报错：Process or Namespace BackendAPI未找到

以下是几个可能导致这个错误的原因和对应的解决办法：

• PM2进程的用户上下文不匹配
  你本地启动pm2用的是自己的服务器用户（比如ec2-user），但Github Actions自托管Runner是用专属的runner用户执行命令的，不同用户的PM2进程列表完全隔离，所以Runner用户下看不到你本地启动的BackendAPI进程。
  解决办法：在工作流的命令里切换到启动pm2的用户执行，比如：

  sudo -u ec2-user pm2 restart BackendAPI
  

  或者先通过whoami确认Runner的执行用户，再检查该用户下的pm2进程列表。

• PM2的配置路径未正确指定
  PM2会把进程数据存在PM2_HOME环境变量指向的目录，不同用户的这个路径默认不一样（比如本地用户是/home/你的用户名/.pm2，Runner用户可能是/home/runner/.pm2）。如果工作流里没指定正确的PM2_HOME，就会读取不到你本地创建的进程。
  解决办法：执行命令时指定正确的PM2_HOME路径：

  PM2_HOME=/home/ec2-user/.pm2 pm2 restart BackendAPI
  

• 进程名称拼写或大小写不一致
  仔细核对本地pm2 list输出的进程名称，是不是和工作流里写的BackendAPI完全一致——PM2对进程名称的大小写是敏感的，比如本地是backendapi，工作流里写大写就会找不到。
  解决办法：用pm2 list里显示的准确名称执行命令，或者直接用进程ID代替名称（比如pm2 restart 0）。

• Runner执行命令的工作目录错误
  如果你的pm2启动命令是依赖项目目录下的配置文件，而Runner执行时的工作目录不是项目根目录，可能导致无法识别进程名称。
  解决办法：在执行pm2命令前先切换到项目目录：

  cd /path/to/your/node/project && pm2 restart BackendAPI
  

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