Jenkins集成Maven报错‘command not found’问题求助

这种情况我碰到过好多次，核心问题就是Jenkins的运行环境和你手动登录shell的环境完全不共享——你在命令行配置的~/.bash_profile根本没被Jenkins加载到！下面给你几个靠谱的解决办法，按优先级来：

1. 直接在Jenkins全局工具配置里指定Maven路径（最省心） #

这是最直接也最不容易出问题的方法，完全绕开PATH的坑：

• 打开Jenkins，进入「系统管理」→「全局工具配置」
• 找到「Maven」板块，点击「新增Maven」
• 取消勾选「自动安装」，然后在「MAVEN_HOME」里直接填你的Maven安装目录，比如/Users/jenkins/apache-maven-3.5.2
• 保存配置后，在你的构建任务里选择这个配置好的Maven，或者在shell步骤里用${MAVEN_HOME}/bin/mvn来执行命令

2. 在Jenkins全局配置里手动设置环境变量 #

如果非要依赖PATH，可以直接在Jenkins里强制指定：

• 进入「系统管理」→「系统配置」
• 找到「全局属性」，勾选「环境变量」
• 添加一条变量：
  • 键：PATH
  • 值：把你需要的路径全写进去，比如/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/Users/jenkins/apache-maven-3.5.2/bin（别用$PATH拼接，因为Jenkins里的默认PATH可能和你命令行的不一样）
• 保存后，再跑构建任务试试，Jenkins会用这个自定义的PATH

3. 调整Jenkins启动时的系统环境变量 #

如果Jenkins是作为系统服务启动的（比如macOS的LaunchDaemon、Linux的systemd），它启动时不会加载用户的shell配置文件，得直接修改服务配置：

如果你用的是macOS： #

1. 编辑Jenkins的启动配置文件：sudo nano /Library/LaunchDaemons/org.jenkins-ci.plist
2. 在<dict>标签内添加环境变量配置：

   <key>EnvironmentVariables</key>
   <dict>
     <key>PATH</key>
     <string>/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/Users/jenkins/apache-maven-3.5.2/bin</string>
   </dict>
   

3. 保存后重启Jenkins服务：

   sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist
   sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist
   

如果你用的是Linux（systemd）： #

1. 编辑Jenkins的service文件：sudo nano /etc/systemd/system/jenkins.service
2. 在[Service]段落里添加：

   Environment="PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/Users/jenkins/apache-maven-3.5.2/bin"
   

3. 重载配置并重启服务：

   sudo systemctl daemon-reload
   sudo systemctl restart jenkins
   

4. 给Jenkins运行用户配置shell环境 #

如果Jenkins是用jenkins用户运行的，你得给这个用户配置非交互式shell的环境（因为Jenkins启动的是非登录非交互式shell，不会加载.bash_profile）：

1. 切换到jenkins用户：sudo su - jenkins（如果提示权限问题，可能需要先给jenkins用户设置密码）
2. 编辑.bashrc文件：nano ~/.bashrc，添加一行：

   export PATH=$PATH:/Users/jenkins/apache-maven-3.5.2/bin
   

3. 保存退出，然后可以先测试一下：在jenkins用户下执行echo $PATH和which mvn，确认路径正确
4. 重启Jenkins服务，让配置生效

快速验证方法 #

可以先新建一个简单的自由风格Jenkins任务，添加一个「执行shell」步骤，输入：

echo $PATH
which mvn
mvn -v

跑一遍构建，看日志里输出的PATH和mvn路径，就能快速定位是哪个环节出问题了。

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