前言

宝塔里通过node管理器安装了对应的node版本后，我们在其对应的node模块管理器中安装pm2模块，虽然pm2模块安装后可以正常使用，但是每次服务器重启，对应的node项目并没有启动，一开始我以为是宝塔的问题。

后来发现并不是这样，为此记录一下，方便后续使用。

---

运行机制解析：进程守护与开机自启的边界

解决该问题的关键，在于区分两层不同维度的守护机制：

1. 应用级进程监控（Runtime Supervision）

   • 机制：当 Node.js 应用触发未捕获异常退出时，内存中运行的 PM2 主守护进程（PM2 Daemon）会自动拉起应用。
   • 范围：仅在操作系统运行期有效，由 PM2 原生提供。

2. 系统级服务持久化（System Init Supervision）

   • 机制：操作系统重启时，内核清空内存空间并初始化系统服务。操作系统必须通过 Init 系统（如 Systemd）主动调用 PM2 的二进制程序并恢复先前的运行上下文。
   • 成因：宝塔面板中安装 PM2 模块仅完成了 Node 全局包的安装，并未向系统级服务管理器（Systemd）注册服务单元。因此，系统重启后 PM2 守护进程并未被系统加载，应用自然无法恢复。

要实现完全持久化，必须显式完成两步：持久化当前运行列表（Dump）与注册系统服务（Register Service）。

---

PM2 状态持久化与 Systemd 注册

在应用正常启动的前提下，登录服务器终端执行以下标准操作：

1. 持久化当前进程快照

pm2 save

该命令将当前正在运行的进程列表、运行参数及路径序列化至磁盘（通常保存于 ~/.pm2/dump.pm2）。若未执行该操作，即便服务自启，PM2 恢复的目标列表也将为空。

2. 注册并启用 Systemd 服务单元

在 root 权限下执行：

pm2 startup

PM2 会自动检测操作系统发行版，并生成适配的环境变量与服务文件。

• 若终端输出以 sudo env PATH=... 开头的命令，请完整复制并在终端中执行。
• 该命令将创建 /etc/systemd/system/pm2-root.service 文件，并将当前 Node 环境变量与服务配置固化写入。

3. 服务可用性验证

systemctl status pm2-root

确认服务指标：

• Loaded: ...; enabled;：确认服务已进入系统开机自启队列。
• Active: active (running)：确认系统服务处于平稳运行状态。

---

多 Node.js 版本环境下的服务失效分析

在多项目共存的环境中，若频繁在宝塔中切换 Node.js 默认版本，会出现服务链断裂的情况。

1. 物理路径隔离

宝塔面板的 Node 版本管理器采用物理目录隔离机制：

• Node v18 路径：/www/server/nodejs/v18.x.x/bin/
• Node v20 路径：/www/server/nodejs/v20.x.x/bin/

当在宝塔中切换全局版本时，新版本环境中并不包含旧版本安装的全局模块。若在新版本下未重新安装 PM2，终端将直接报错 command not found。

2. 固化 PATH 引发的服务崩溃

pm2 startup 在生成 pm2-root.service 时，会将执行命令时的 Node 绝对路径硬编码到配置中。
如果切换了系统全局 Node 版本，或者移除了先前生成服务的 Node 版本：

• Systemd 在启动 pm2-root.service 时将因路径失效而直接进入 inactive (dead) 或 failed 状态。
• 因此，若通过常规方式切换全局 Node 环境，必须重新安装 PM2，并重新执行 pm2 unstartup 与 pm2 startup 重构系统服务。

---

单一守护进程与多运行时调度实践

为了避免在多版本共存时频繁重构系统服务，推荐采用“单管理核心 + 多运行时调度”方案。

核心设计原则

选择一个稳定的 Node.js LTS 版本作为底座，只构建唯一的系统级 PM2 守护服务；具体的业务应用通过指定 Node 执行路径（Interpreter）实现运行时隔离。

实施步骤

1. 锁定基础环境与系统服务

在宝塔中选定一个长期支持的 Node 版本（如 Node 20），在此版本下安装 PM2，并按第二节的步骤完成 pm2 save 和 pm2 startup。后续不再变动全局 PM2 服务。

2. 定位各版本的 Node 执行文件绝对路径

宝塔默认安装路径规则如下：

• Node 16：/www/server/nodejs/v16.x.x/bin/node
• Node 18：/www/server/nodejs/v18.x.x/bin/node

3. 通过 Interpreter 参数指派运行时

• CLI 命令行调度方式：

  # 调度至 Node 16 运行
  pm2 start app.js --name "service-a" --interpreter /www/server/nodejs/v16.x.x/bin/node
  
  # 调度至 Node 18 运行
  pm2 start index.js --name "service-b" --interpreter /www/server/nodejs/v18.x.x/bin/node

• 配置文件（ecosystem.config.js）调度方式（推荐）：

  module.exports = {
      apps: [
          {
              name: "legacy-api",
              script: "./server.js",
              interpreter: "/www/server/nodejs/v16.20.2/bin/node",
          },
          {
              name: "modern-service",
              script: "./app.js",
              interpreter: "/www/server/nodejs/v18.19.0/bin/node",
          },
      ],
  };

4. 固化调度状态

项目启动完成后，更新快照：

pm2 save