如何在Maven的pom.xml中获取Jenkins流水线设置的环境变量

云上老周

2026-4-30

刚好我之前碰到过类似的问题，给你梳理下解决方案：

一、在pom.xml中正确获取Jenkins流水线环境变量的方法

要让Maven的docker-maven-plugin拿到Jenkins的环境变量，得确保变量能从Jenkins流水线传递到Maven进程，再正确映射到插件的buildArgs里，具体步骤如下：

第一步：确保Jenkins流水线里的变量能被Maven读取
Jenkins流水线的环境变量默认会传递给子进程，但有时候需要显式声明（比如在withEnv块里包装），避免变量被隔离。比如你的流水线构建阶段可以这么写：
```
stage('Build Docker Image') {
    steps {
        // 显式传递需要的环境变量给Maven进程
        withEnv(["JENKINS_USER_NAME=${env.JENKINS_USER_NAME}"]) {
            sh 'mvn clean package docker:build'
        }
    }
}
```

第二步：在pom.xml中正确引用变量到docker-maven-plugin
Maven里用${env.VAR_NAME}的语法读取环境变量，直接把它配置到插件的buildArgs中即可。示例配置如下：

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>1.2.2</version> <!-- 替换成你实际使用的插件版本 -->
    <configuration>
        <imageName>your-custom-image</imageName>
        <buildArgs>
            <!-- 直接引用Jenkins传递过来的环境变量 -->
            <JENKINS_USER_NAME>${env.JENKINS_USER_NAME}</JENKINS_USER_NAME>
        </buildArgs>
        <!-- 其他插件配置（比如Dockerfile路径等） -->
    </configuration>
</plugin>

如果遇到插件解析${env.*}有问题的情况，可以先在pom.xml的<properties>块中定义一个中间属性，再引用：

<properties>
    <jenkins.user>${env.JENKINS_USER_NAME}</jenkins.user>
</properties>

然后在buildArgs里用${jenkins.user}即可。

第三步：验证变量传递
可以在Jenkins流水线里先打印变量确认存在，比如加一行sh 'echo $JENKINS_USER_NAME'，或者在Dockerfile里用ARG JENKINS_USER_NAME后打印这个变量，确保传递成功。

二、解决重复触发任务的卷挂载权限问题

你推测的权限问题完全正确，第一次运行容器时，test-output目录被容器内的用户创建，所有权属于容器用户（通常是root），而第二次Jenkins任务运行时，Jenkins的系统用户（比如jenkins用户）没有权限修改这个目录下的文件，导致报错。推荐这几种解决方案：

方案1：让容器进程使用与Jenkins宿主机一致的UID/GID
这是最规范的做法，避免权限冲突。

在流水线里获取Jenkins用户的UID和GID：

stage('Build Docker Image') {
    steps {
        script {
            def jenkinsUid = sh(script: 'id -u', returnStdout: true).trim()
            def jenkinsGid = sh(script: 'id -g', returnStdout: true).trim()
            withEnv(["JENKINS_UID=${jenkinsUid}", "JENKINS_GID=${jenkinsGid}", "JENKINS_USER_NAME=${env.JENKINS_USER_NAME}"]) {
                sh 'mvn clean package docker:build'
            }
        }
    }
}

在pom.xml的buildArgs里添加这两个变量：

<buildArgs>
    <JENKINS_USER_NAME>${env.JENKINS_USER_NAME}</JENKINS_USER_NAME>
    <JENKINS_UID>${env.JENKINS_UID}</JENKINS_UID>
    <JENKINS_GID>${env.JENKINS_GID}</JENKINS_GID>
</buildArgs>

在Dockerfile里创建匹配UID/GID的用户并切换：

ARG JENKINS_UID
ARG JENKINS_GID
# 创建用户组和用户，匹配Jenkins宿主机的UID/GID
RUN groupadd -g ${JENKINS_GID} jenkins-runner && \
    useradd -u ${JENKINS_UID} -g jenkins-runner -m jenkins-runner
# 切换到该用户运行后续命令
USER jenkins-runner

方案2：运行容器时指定Jenkins用户的UID/GID
如果不想修改Dockerfile，可以在运行容器时用--user参数直接指定：
```
stage('Run Test Container') {
    steps {
        sh "docker run --user $(id -u):$(id -g) -v ${WORKSPACE}/test-output:/app/test-output your-custom-image"
    }
}
```
这样容器内的进程会以Jenkins用户的UID/GID运行，创建的文件所有权会和Jenkins用户一致，不会有权限问题。

方案3：每次运行前清理或修复目录权限
这是临时应急的方法，不推荐长期使用（因为777权限不安全）：

stage('Prepare Workspace') {
    steps {
        // 清理旧的test-output目录
        sh 'rm -rf ${WORKSPACE}/test-output || true'
        // 或者修改目录权限
        // sh 'chmod -R 777 ${WORKSPACE}/test-output || true'
    }
}

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