jenkins执行shell 找不到pm2

在 Jenkins 执行 Shell 时遇到pm2: command not found是非常常见的问题，根本原因是Jenkins 运行环境的 PATH 变量与用户登录环境不一致。

以下是完整的解决方案，按推荐顺序排列：

1. 使用绝对路径（最可靠）

在 Jenkins 服务器上先查找 pm2 的真实路径：

bash

复制

which pm2 # 示例输出：/root/.nvm/versions/node/v16.15.1/bin/pm2

然后在 Jenkins Shell 中使用完整路径：

bash

复制

/root/.nvm/versions/node/v16.15.1/bin/pm2 restart your-app

2. 创建软链接（常用方案）

将 pm2 链接到系统 PATH 目录：

bash

复制

# 查找 pm2 路径 which pm2 # 输出如 /root/.nvm/versions/node/v16.15.1/bin/pm2 # 创建软链接（推荐 /usr/local/bin） sudo ln -s /root/.nvm/versions/node/v16.15.1/bin/pm2 /usr/local/bin/pm2 sudo ln -s /root/.nvm/versions/node/v16.15.1/bin/node /usr/local/bin/node sudo ln -s /root/.nvm/versions/node/v16.15.1/bin/npm /usr/local/bin/npm

3. 在 Jenkins Shell 中加载环境

在 Jenkins 的"执行 Shell"步骤开头添加：

bash

复制

# 加载系统环境变量 source /etc/profile # 如果使用 NVM，必须加载 NVM 脚本 export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 然后执行 pm2 命令 pm2 restart your-app

4. 配置 Jenkins 全局环境变量

在 Jenkins 系统设置中：

1. Manage Jenkins → System → Global Properties

2. 勾选Environment variables

3. 添加变量：

   • PATH：/usr/local/bin:/usr/bin:/bin:/your/node/path

   • 或添加NODE_HOME：/root/.nvm/versions/node/v16.15.1

5. 使用 npx（临时方案）

如果不想配置环境，可以直接使用 npx：

bash

复制

npx pm2 restart your-app

6. 权限问题处理

如果提示权限不足，确保 Jenkins 用户有权访问 pm2：

bash

复制

# 查看 Jenkins 运行用户 ps aux | grep jenkins # 如果是 jenkins 用户，建议用 root 运行或配置 sudo # 在 /etc/sudoers 中添加： jenkins ALL=(ALL) NOPASSWD: /usr/local/bin/pm2

然后在 Jenkins Shell 中使用：

bash

复制

sudo pm2 restart your-app

快速验证：在 Jenkins 中添加一个"执行 Shell"步骤，运行以下命令测试：

bash

复制

echo $PATH which node which pm2 pm2 --version

根据输出结果选择最适合你的解决方案。通常方案1或方案2能彻底解决大部分问题。