已安装Pipeline Maven Integration Plugin仍报'mvn: not found'错误原因排查

出现这个错误的核心是Jenkins执行构建的代理节点上无法定位Maven命令，具体分以下几种情况：

• 代理节点未安装Maven：你配置的Pipeline Maven Integration Plugin只是提供Pipeline与Maven的集成能力，不会自动给Jenkins代理节点（包括master或远程slave）安装Maven本身，没装的话自然找不到mvn命令。
• Maven未加入系统PATH：就算代理节点装了Maven，但mvn所在的目录没被添加到系统环境变量PATH中，Shell执行时就无法找到该命令。
• Jenkins未配置Maven工具路径：已经在节点上装了Maven，但没在Jenkins「全局工具配置」里指定Maven的安装路径（可以选自动下载安装或手动指定本地路径），导致Pipeline无法识别Maven位置。这种情况需要在Pipeline里通过tools块引用全局配置的Maven，而不是直接用Shell调用mvn。
• Agent节点分配问题：你的Pipeline用了agent any，可能随机分配到了一台没装Maven的代理节点。如果只有特定节点部署了Maven，应该指定带对应标签的节点，比如agent { label 'maven-ready' }。

附优化后的Pipeline写法（利用Pipeline Maven插件的能力）：

pipeline {
    agent any
    tools {
        maven 'Maven-3.9.6' // 这里名称要和Jenkins全局工具配置里的Maven名称一致
    }
    stages {
        stage('Build') {
            steps {
                echo 'Building the project...'
                mvn 'clean install'
            }
        }
        stage('Test') {
            steps {
                echo 'Running tests...'
                mvn 'test'
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploy step (for demo purposes)...'
            }
        }
    }
}

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