已安装Git、Maven，Jenkins仍报找不到错误的解决求助

问题概述 #

执行Pipeline时遇到两个关键错误：

1. 提示「Selected Git installation does not exist」
2. Maven构建阶段报错「mvn: command not found」，导致后续部署阶段被跳过

一、解决「Selected Git installation does not exist」错误 #

原因 #

Jenkins全局工具配置中未正确注册Git，或者Pipeline的Git步骤引用了不存在的Git安装名称。

操作步骤 #

1. 进入Jenkins后台 → 「Manage Jenkins」→ 「Global Tool Configuration」
2. 找到「Git」配置区，点击「Add Git」：
   • 填写名称（例如「Default」）
   • 指定Git的实际路径（从报错日志看，你的Git路径是/usr/bin/git）
3. 保存配置后，若保留自定义的Git Checkout阶段，需在Git步骤中添加tool参数指定已配置的Git名称：

   git credentialsId: 'gitid', url: 'https://github.com/kdhani/myweb-p1.git', tool: 'Default'
   

   另外，你的Pipeline中出现了两次Git checkout（Declarative自动执行的和自定义的「Git Checkout」阶段），建议移除自定义阶段，让Declarative Pipeline自动处理代码拉取，避免重复操作。

二、解决「mvn: command not found」错误 #

原因 #

环境变量PATH配置可能有误，或者未通过Jenkins的全局工具管理加载Maven，导致Jenkins Agent无法找到mvn命令。

推荐解决方案：使用Jenkins全局Maven工具配置 #

1. 进入Jenkins后台 → 「Manage Jenkins」→ 「Global Tool Configuration」
2. 找到「Maven」配置区，点击「Add Maven」：
   • 填写名称（例如「Maven3」）
   • 可选择自动安装Maven，或指定本地已安装的Maven路径（确保路径正确，比如/opt/maven3）
3. 修改Jenkinsfile，通过tools指令加载配置好的Maven和Git：

修改后的完整Jenkinsfile #

pipeline {
    agent any
    
    tools {
        maven 'Maven3' // 与全局配置的Maven名称一致
        git 'Default'  // 与全局配置的Git名称一致
    }
    
    stages {
        stage("Maven Build") {
            steps {
                sh "mvn clean package"
                sh "mv target/*.war target/myweb.war"
            }
        }
        stage("deploy-dev") {
            steps {
                sshagent(['tomcat-new']) {
                    sh """
                        scp -o StrictHostKeyChecking=no target/myweb.war ec2-user@172.31.33.108:/home/ec2-user/apache-tomcat-9.0.63/webapps/
                        
                        ssh ec2-user@172.31.33.108 /home/ec2-user/apache-tomcat-9.0.63/bin/shutdown.sh
                        
                        ssh ec2-user@172.31.33.108 /home/ec2-user/apache-tomcat-9.0.63/bin/startup.sh
                    """
                }
            }
        }
    }
}

备选方案：修正PATH配置 #

如果直接在Agent机器上安装了Maven，先通过which mvn确认实际路径，再修改Pipeline的environment配置：

environment {
    PATH = "/opt/maven3/bin:$PATH" // 替换为实际的Maven bin路径
}

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