Jenkins执行PM2命令提示‘pm2: not found’的问题排查求助

这个报错的核心原因是Jenkins的Shell执行环境没有包含PM2所在的路径——虽然你在自己的用户（me）环境下能正常使用PM2，但Jenkins默认以jenkins用户运行，且不会自动加载普通用户的Shell配置（比如.bashrc/.nvm.sh），导致找不到PM2的可执行文件。下面是几个针对性的解决方案：

1. 直接使用PM2的绝对路径执行（快速临时方案） #

先在你的me用户终端里执行以下命令，获取PM2的实际路径：

which pm2

会得到类似/home/me/.nvm/versions/node/v18.17.0/bin/pm2的输出。然后在Jenkins的Execute Shell步骤里，用这个绝对路径替换pm2命令：

/home/me/.nvm/versions/node/v18.17.0/bin/pm2 reload app-dev

这种方法不需要修改环境配置，适合快速验证。

2. 在Jenkins Shell中加载NVM环境（推荐方案） #

因为你用NVM管理Node，Jenkins的Shell默认不会加载NVM的配置，所以需要在执行PM2命令前手动加载NVM脚本：

# 加载NVM环境
source /home/me/.nvm/nvm.sh
# 切换到你使用的Node版本（替换成实际版本号）
nvm use 18.17.0
# 执行PM2命令
pm2 reload app-dev

这样Jenkins的Shell环境就能识别到NVM管理的Node和全局安装的PM2了。

3. 配置Jenkins全局环境变量（持久化方案） #

如果不想每次构建都写加载NVM的代码，可以把PM2所在的路径添加到Jenkins的全局PATH中：

• 进入Jenkins的「系统管理」→「系统设置」
• 找到「全局属性」，勾选「环境变量」
• 添加一个键为PATH，值为${PATH}:/home/me/.nvm/versions/node/v18.17.0/bin的变量（替换成你的PM2实际路径）
• 保存配置后，后续的构建就能直接使用pm2命令了

4. 验证Jenkins用户的环境（排查辅助） #

如果上面的方法还不行，可以在Execute Shell里先打印环境变量，对比你自己终端的环境：

# 打印Jenkins的PATH
echo $PATH
# 尝试查找PM2
which pm2

通过对比PATH差异，就能明确Jenkins环境缺少哪个路径。另外注意：Jenkins默认使用非交互式Shell，不会加载.bashrc，如果要让jenkins用户默认加载NVM，可以把source /home/me/.nvm/nvm.sh添加到/var/lib/jenkins/.profile文件中（需要有jenkins用户的编辑权限）。

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