MERN应用部署后npm install、pm2 restart未生效？需手动重启服务器

问题描述 #

我的MERN应用部署工作流里，除npm install及后续步骤外其他环节都正常，工作流显示执行成功，但后端代码变更必须手动重启服务器才会生效，而且日志里完全没报错。附上我的GitHub Actions部署配置：

name: Deploy to DigitalOcean

on:
 push:
    branches:
      - main

jobs:
  deploy:
  runs-on: ubuntu-latest

steps:
  # Step 1: Check out the code from the repository
  - name: Checkout code
    uses: actions/checkout@v3

  # Step 2: Set up SSH agent using your private key stored in GitHub Secrets
  - name: Set up SSH agent
    uses: webfactory/ssh-agent@v0.7.0
    with:
      ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

  # Step 3: Deploy to DigitalOcean and create a .env file
  - name: Deploy to DigitalOcean
    run: |
      ssh -o StrictHostKeyChecking=no root@137.184.41.82 << 'EOF'
        # Navigate to the application directory
        cd /root/circlo-app
        
        # Pull the latest code from the main branch
        git pull origin main
        
        # Create a .env file
        cat <<EOT > .env
        ...env vars
        EOT
        
        npm ci --production
        npm ci -g pm2
        echo "Restarting application..."
        pm2 restart all
        pm2 list
        echo "Application restarted."
      EOF
      echo "Deployment complete."

可能的问题原因 #

• PM2重启命令未精准命中目标进程：pm2 restart all看似没问题，但如果服务器上有其他PM2进程，或者你的后端进程名称有变化，可能导致重启命令没作用到正确的进程；另外如果PM2是在非root用户下运行的，用root执行pm2 restart all可能操作的是另一个PM2实例。
• 重复全局安装PM2引发冲突：每次部署都执行npm ci -g pm2，会重复覆盖安装PM2，可能导致现有PM2进程管理混乱，重启命令无法正常触发进程重启。
• 依赖更新不彻底：npm ci --production虽然会安装生产依赖，但如果之前的node_modules有缓存残留，可能导致新依赖没生效，进而代码变更没被加载。
• SSH会话环境与PM2运行环境不匹配：SSH登录后的环境变量（比如PATH）和PM2运行时的环境变量不一致，导致pm2 restart命令看似执行成功，但实际没触达目标进程。

修复方案 #

1. 精准指定PM2进程名称重启
   先在服务器上执行pm2 list，找到你的后端进程的名称（比如circlo-backend），然后把部署脚本里的pm2 restart all改成pm2 restart [进程名称]，确保只重启目标应用。

2. 移除重复安装PM2的步骤
   服务器上只需要安装一次PM2，删掉部署脚本中的npm ci -g pm2这一行，避免每次安装带来的版本冲突或进程管理混乱。

3. 优化依赖更新流程
   在执行npm ci --production前，先清除旧的依赖文件，确保依赖完全更新：

   rm -rf node_modules package-lock.json
   npm ci --production
   

4. 添加重启验证步骤
   在部署脚本中加入进程状态和日志检查，确认重启是否真的生效：

   pm2 restart circlo-backend
   pm2 show circlo-backend  # 查看进程详情，确认"restart time"是否为最新时间
   pm2 logs circlo-backend --lines 20  # 查看最新日志，确认是否有重启记录
   

5. 使用应用运行用户执行部署命令
   如果你的后端应用不是用root用户运行的，切换到对应用户（比如su - ubuntu）执行部署操作，避免PM2进程归属不同用户导致命令无效。

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