重建Node.js应用时PM2显示旧版本的解决方法咨询

我之前也碰到过一模一样的情况！核心问题其实是你的构建流程和PM2的重启逻辑没配合好，导致中间出现了首次启动的初始版本。要解决这个，核心思路就是零停机部署——让旧版本持续运行直到新版本完全构建完成并就绪，再无缝切换，绝对不让用户看到中间的异常状态。

下面是几个实操的解决方法，按优先级来：

1. 用PM2生态系统配置文件+pm2 reload实现无缝切换 #

先搞一个ecosystem.config.js配置文件，把应用的启动、部署逻辑都写进去，重点用pm2 reload替代普通的restart。reload的逻辑是先启动新实例，等新实例完全就绪后再关掉旧实例，全程用户访问的都是正常版本。

举个配置示例：

module.exports = {
  apps: [{
    name: '你的应用名',
    script: './dist/index.js', // 这里填你构建后的入口文件路径
    instances: 'max', // 按CPU核数启动实例，集群模式
    exec_mode: 'cluster',
    env: {
      NODE_ENV: 'production'
    },
    wait_ready: true // 关键！等待应用发送ready信号才认为实例就绪
  }],
  deploy: {
    production: {
      user: '你的服务器用户名',
      host: '服务器IP',
      ref: 'origin/main', // 要拉取的分支
      repo: '你的GitHub仓库地址',
      path: '/var/www/你的应用目录',
      // 拉取后的部署脚本：安装依赖→构建→无缝重载
      'post-deploy': 'npm install && npm run build && pm2 reload ecosystem.config.js --env production'
    }
  }
};

还要在你的Node.js应用代码里加一行，当服务完全启动时给PM2发就绪信号，比如Express应用：

const app = express();
const server = app.listen(3000, () => {
  console.log('服务启动成功！');
  // 给PM2发信号，告诉它实例就绪了
  process.send('ready');
});

2. 先在临时目录构建，再替换生产文件 #

如果直接在当前运行的目录拉取代码构建，很可能会覆盖旧文件，导致正在运行的旧进程读取到不完整的新文件，意外加载到初始版本。这个时候可以换个思路：

• 把新代码拉到服务器的临时目录（比如/tmp/your-app-new）
• 在临时目录里执行npm install和npm run build，完成构建
• 把构建好的产物（比如dist文件夹）替换到PM2运行的生产目录
• 最后执行pm2 reload切换版本

这样旧版本全程在原来的目录正常运行，直到新产物完全替换好才切换，完全不会出问题。

3. 清理PM2缓存，强制更新环境变量 #

有时候PM2会缓存旧的文件路径或者环境变量，导致重启后还是加载旧版本。可以在重载的时候加--update-env参数，强制刷新：

pm2 reload ecosystem.config.js --env production --update-env

另外，如果你的应用本身有缓存（比如Node.js的require缓存），可以在构建后手动清理相关缓存文件，或者在应用启动时加一段清理缓存的逻辑（不过这个要谨慎，避免影响性能）。

最后验证一下 #

每次部署后，可以用pm2 list看看实例状态，确保新实例都正常启动，旧实例已经被替换掉。也可以手动访问一下网站，确认显示的是最新版本，中间没有出现异常的初始版本。

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