Jenkins全局工具配置Maven后执行shell提示mvn not found问题排查

我之前也踩过一模一样的坑！明明在全局工具里配置好了Maven，JAVA_HOME和java -version都正常输出，偏偏shell里跑mvn就提示找不到。给你几个亲测有效的排查和解决方向：

1. 改用Jenkins自带的Maven构建步骤（最省心） #

FreeStyle任务里别直接用shell执行mvn，换成Jenkins内置的Invoke top-level Maven targets构建步骤——这个会自动调用你在全局工具里配置的Maven，完全不用操心环境变量的问题，我当时就是这么快速解决的。

2. 确认任务是否继承了全局Maven的环境变量 #

如果非要用shell执行，得确保Jenkins把全局Maven的路径注入到当前任务的环境中：

• 打开任务配置，在构建环境区域，检查是否有类似“Use configured Maven from Global Tools”的勾选选项（不同Jenkins版本可能表述略有不同）；
• 或者在shell步骤里先打印环境变量，看看PATH里有没有包含Maven的bin目录：

echo $PATH

如果没有，说明Maven的路径没被加载进来。

3. 手动指定Maven绝对路径 #

先在Jenkins服务器上找到你配置的Maven安装路径（比如/usr/local/apache-maven-3.9.4/bin），然后在shell里用绝对路径执行命令：

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

如果能成功，就实锤是环境变量的问题了。

4. 给Jenkins添加全局Maven环境变量 #

进入Jenkins的系统管理 -> 系统配置，找到「全局属性」区域：

• 勾选「环境变量」；
• 添加一条变量：名称填PATH+EXTRA，值填你的Maven安装目录下的bin路径（比如/usr/local/apache-maven-3.9.4/bin）；
  这样所有Jenkins任务的shell环境都会自动包含Maven的路径，以后直接用mvn命令就没问题了。

为啥Java命令正常？ #

因为JAVA_HOME和Java的路径通常是配置在系统全局环境变量里（比如/etc/profile或~/.bashrc），Jenkins启动时会加载这些全局变量；但Maven你只在Jenkins全局工具里配置了，没加到系统环境变量，Jenkins的shell子进程不会自动继承全局工具里的Maven路径，所以就找不到mvn命令啦。

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