Jenkins Pipeline使用Docker Agent时工作区异常问题求助

你遇到的问题核心是Jenkins Pipeline的agent隔离机制：当你在stage里单独指定agent { docker {...} }时，Jenkins会为这个stage分配一个全新的执行上下文，包括创建一个带@2后缀的独立工作区（比如test@2），而不是复用你在第一个Clone阶段使用的原工作区test。这就导致Maven容器里挂载的还是旧的test工作区路径，但实际执行时的工作区是test@2，自然找不到克隆下来的POM文件。

方法一：复用原有节点工作区（最简单） #

在docker agent配置里添加reuseNode true，这个参数会让当前stage复用之前主agent的工作区，不会创建新的@2工作区，代码直接共享。修改后的Pipeline代码如下：

pipeline {
    agent any
    stages {
        stage('Clone') {
            steps {
                git branch: "master", url: "https://github.com/lvthillo/maven-hello-world.git"
            }
        }
        stage('Build in Docker') {
            agent {
                docker {
                    image "maven:3.5.2"
                    args '-v /var/jenkins_home/workspace/test:/opt/maven -w /opt/maven'
                    reuseNode true  // 关键：复用原有节点的工作区
                }
            }
            steps {
                sh 'pwd'
                sh 'mvn -v'
                sh 'mvn clean install'
            }
        }
    }
}

这样修改后，Maven阶段会直接使用Clone阶段的工作区，pwd输出会变成/var/jenkins_home/workspace/test，自然能找到POM文件。

方法二：动态映射当前工作区（更灵活） #

如果你需要保持容器的完全隔离，不想复用节点工作区，可以用Jenkins内置的${WORKSPACE}变量动态获取当前工作区路径，替换你args里的固定路径。这样不管Jenkins生成什么后缀的工作区，都能正确映射到容器内：

pipeline {
    agent any
    stages {
        stage('Clone') {
            steps {
                git branch: "master", url: "https://github.com/lvthillo/maven-hello-world.git"
            }
        }
        stage('Build in Docker') {
            agent {
                docker {
                    image "maven:3.5.2"
                    args "-v ${WORKSPACE}:/opt/maven -w /opt/maven"  // 用变量动态映射工作区
                }
            }
            steps {
                sh 'pwd'
                sh 'mvn -v'
                sh 'mvn clean install'
            }
        }
    }
}

这个方法的好处是，即使后续Jenkins生成@3、@4这类工作区，容器也能准确挂载到当前执行的工作区，避免路径硬编码带来的问题。

• reuseNode true适合大多数场景，配置简单，能直接共享代码；
• 动态映射工作区更适合复杂场景，比如同一个Pipeline里有多个不同容器需要共享代码，或者工作区路径可能变化的情况。

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