Jenkins Pipeline DSL执行Maven命令报错：mvn未找到及@tmp目录异常

我之前处理过好几个类似的Jenkins Pipeline构建失败的案例，你的问题其实是两个常见坑的叠加：Maven没有被正确加入Jenkins执行环境的PATH，再加上执行mvn命令时不在代码克隆的实际目录下，下面分步骤给你解决办法：

1. 先解决mvn: not found的核心问题 #

这个报错本质是Jenkins的执行节点（不管是master还是slave）找不到Maven的可执行文件，有两种可靠的解决方式：

方式一：通过Jenkins全局工具配置绑定Maven #

• 先进入Jenkins的「全局工具配置」页面，找到Maven配置项，添加一个Maven安装（可以选择自动下载或者指定本地已安装的路径），记得给这个安装配置起个名字（比如Maven-3.8.6）。
• 然后在你的Pipeline脚本里，用tools块引用这个配置，Jenkins会自动把Maven的bin目录加入当前构建的PATH中：

pipeline {
    agent any
    tools {
        maven 'Maven-3.8.6' // 这里填你在全局工具配置里的Maven名称
    }
    stages {
        stage('Checkout Code') {
            steps {
                // 这里是你的SCM克隆步骤，比如git
                git url: '你的代码仓库地址', branch: 'main'
            }
        }
        stage('Build Project') {
            steps {
                sh 'mvn clean install -Dmaven.test.skip=true -Dfindbugs.skip=true'
            }
        }
    }
}

方式二：使用带Maven的Docker Agent（适合容器化构建场景） #

如果你的Pipeline用了Docker作为执行环境，直接选择内置Maven的官方镜像，这样容器里自带Maven环境，不需要额外配置：

pipeline {
    agent {
        docker { image 'maven:3.8.6-openjdk-11' } // 选择合适的Maven+JDK镜像
    }
    stages {
        stage('Checkout Code') {
            steps {
                git url: '你的代码仓库地址', branch: 'main'
            }
        }
        stage('Build Project') {
            steps {
                sh 'mvn clean install -Dmaven.test.skip=true -Dfindbugs.skip=true'
            }
        }
    }
}

2. 解决代码目录错误的问题 #

你提到流水线在@tmp目录找pom.xml，说明执行mvn命令时的工作目录不对。解决这个问题很简单：

• 先查看Checkout步骤的控制台输出，确认代码被克隆到了哪个目录（比如可能是一个子目录my-project）。
• 在Build步骤里用dir()块切换到代码所在的目录再执行命令：

stage('Build Project') {
    steps {
        dir('my-project') { // 替换成你实际的代码目录
            sh 'mvn clean install -Dmaven.test.skip=true -Dfindbugs.skip=true'
        }
    }
}

最后验证顺序 #

建议先解决Maven路径问题，再确认目录是否正确——因为如果Maven路径不对，就算目录对了还是会报错；而目录不对的话，即使Maven能找到，也会提示找不到pom.xml。

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