Jenkins执行mvn命令报错：mvn: command not found问题求助

这个问题我之前帮不少人排查过，核心原因就是Jenkins运行的jenkins用户和你登录的ec2-user环境变量完全是独立的——你在ec2-user下配置的PATH、MAVEN_HOME只对该用户生效，而jenkins用户有自己的环境变量空间，尤其是Jenkins作为系统服务启动时，默认不会加载普通用户的profile配置，所以识别不到mvn命令。

下面是几种靠谱的解决方法，按推荐程度排序：

方法一：在Jenkins全局配置中注入环境变量（最推荐） #

这是最通用的方式，所有Jenkins构建都会自动继承这些变量：

1. 进入Jenkins后台，点击「Manage Jenkins」→「Configure System」
2. 找到「Global properties」区域，勾选「Environment variables」
3. 添加两个变量：
   • 变量名：MAVEN_HOME，值填你的Maven安装路径（比如/usr/local/apache-maven-3.5.3）
   • 变量名：PATH，值填$MAVEN_HOME/bin:$PATH（确保Maven的bin目录被加到路径最前面）
4. 保存配置，重新运行构建即可。

方法二：给jenkins用户配置专属环境变量 #

如果希望jenkins用户本身就能直接用mvn命令，可以修改它的用户配置文件：

1. 登录EC2服务器，切换到jenkins用户：su - jenkins（如果提示权限问题，用sudo su - jenkins）
2. 编辑用户的profile文件，比如vi ~/.bash_profile或者vi ~/.profile，添加以下内容：

   export MAVEN_HOME=/usr/local/apache-maven-3.5.3
   export PATH=$MAVEN_HOME/bin:$PATH
   

3. 让配置生效：source ~/.bash_profile
4. 测试一下：mvn -v，如果能正常输出版本说明配置成功
5. 最后重启Jenkins服务：sudo systemctl restart jenkins（如果是旧版本可能用sudo service jenkins restart）

方法三：在构建脚本中直接使用mvn绝对路径（临时应急） #

如果只是临时解决单个构建的问题，可以直接写mvn的完整路径：

/usr/local/apache-maven-3.5.3/bin/mvn -v

这个方法简单但不通用，适合快速验证问题。

方法四：修改Jenkins启动脚本注入环境变量 #

如果Jenkins是通过系统服务启动的，可以修改它的启动配置文件，让进程本身加载环境变量：

1. 找到Jenkins的启动配置文件，通常在/etc/default/jenkins（Debian/Ubuntu）或/etc/sysconfig/jenkins（CentOS/RHEL）
2. 打开文件，添加以下内容：

   MAVEN_HOME=/usr/local/apache-maven-3.5.3
   PATH=$MAVEN_HOME/bin:$PATH
   export MAVEN_HOME PATH
   

3. 保存后重启Jenkins服务：sudo systemctl restart jenkins

最后再确认一下：你可以先切换到jenkins用户，执行echo $PATH和echo $MAVEN_HOME，看看是不是和ec2-user下的一致——如果不一致，就说明是环境变量没有同步的问题，用上面的方法就能解决。

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