Jenkins主节点并发构建时工作区文件互相干扰如何解决？

该异常属于Jenkins Docker Pipeline插件的已知路径逻辑缺陷：docker.build()方法默认读取的构建上下文路径为任务绑定的固定主工作区（即/var/lib/jenkins/workspace/job_name），不会自动适配并发构建时系统自动生成的job_name@2、job_name@3这类后缀隔离工作区。多构建并发执行时，会出现不同构建实例的文件读写错位：比如实例A将代码拉取到自身专属的@2工作区，但docker构建步骤实际读取的是主工作区内实例B残留的Dockerfile或源码，最终导致构建引用的文件和当前Git拉取的版本不匹配。

方案1：显式指定当前工作区为Docker构建上下文（推荐，可保留并发能力） #

修改docker.build()传参，显式传入当前构建实例的工作区绝对路径作为构建上下文，同时明确指定Dockerfile位置，跳过插件默认的固定路径逻辑。
调整后的流水线参考：

pipeline{
    agent any
    stages{
        stage("Pull Source Code"){
            steps{
                checkout scm
            }
        }
        stage("Build and Push image"){
            steps{
                script{
                    docker.withRegistry(...){
                        // 第二个参数显式指定Dockerfile路径和构建上下文为当前工作区
                        def image = docker.build("自定义镜像名:${env.BUILD_ID}", "-f ${pwd()}/Dockerfile ${pwd()}")
                        image.push()
                    }
                }
            }
        }
    }
}

配置中${pwd()}会动态获取当前构建实例所在工作区的绝对路径，无论系统分配的是默认主工作区还是带数字后缀的隔离工作区，都能保证构建步骤读取的是当前构建自己拉取的代码和Dockerfile，不会出现跨工作区文件读取的问题。

方案2：分配完全独立的自定义工作区 #

如果不想调整Docker构建参数，可在流水线顶层配置自定义工作区规则，给每个构建实例分配完全独立、不会复用的工作区路径，从根源上避免路径共享冲突：

pipeline{
    agent any
    options {
        // 每个构建分配带唯一BUILD_ID的独立工作区
        ws("${JENKINS_HOME}/workspace/${JOB_NAME}/build-${BUILD_ID}")
        skipDefaultCheckout(true)
        // 可按需配置构建后自动清理工作区，减少磁盘占用
        cleanWs()
    }
    stages{
        stage("Pull Source Code"){
            steps{
                checkout scm
            }
        }
        stage("Build and Push image"){
            steps{
                script{
                    docker.withRegistry(...){
                        def image = docker.build(...)
                        image.push()
                    }
                }
            }
        }
    }
}

该配置下不存在多个构建共享固定主工作区的情况，每个并发构建的文件读写都在专属目录内完成，不会出现文件覆盖、错位问题。

临时规避方案（不推荐长期使用） #

如果暂时无法调整流水线配置，可在任务并发配置中开启工作区锁，即工作区被占用时后续构建等待锁释放后再执行。但该方案本质是让构建串行使用工作区，会大幅降低并发执行效率，仅适合临时救急使用。

• 流水线内所有文件操作不要硬编码工作区路径，统一用pwd()获取当前工作区的绝对路径，避免路径偏移。
• 可在代码拉取阶段完成后增加ls -l ${pwd()}步骤打印当前工作区文件列表，出现异常时可快速定位是否存在路径读取错误。
• 配置修复前建议先手动清理/var/lib/jenkins/workspace/job_name目录下的残留旧文件，避免历史垃圾文件干扰后续构建。

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