Jenkins Pipeline中Maven命令无法正确读取withCredentials变量问题

我刚踩过这个坑！Jenkins Pipeline通过withCredentials注入的变量属于Pipeline的环境变量上下文，而Maven默认不会自动读取这些变量，直接在pom.xml里用${git.user}肯定拿不到值。下面给你几个实用的解决方案：

方案1：通过Maven命令行参数传递凭证 #

这是最简单直接的方式，把Pipeline里的凭证变量作为-D参数传给Maven，覆盖pom里的配置。示例Pipeline代码：

pipeline {
    agent any
    stages {
        stage('Execute JGitFlow Release') {
            steps {
                // 注入Git用户名密码凭证
                withCredentials([usernamePassword(
                    credentialsId: '你的Git凭证ID',
                    usernameVariable: 'GIT_USER',
                    passwordVariable: 'GIT_PASSWORD'
                )]) {
                    // 执行jgitflow的release命令，通过-D参数传递变量
                    sh '''
                        mvn jgitflow:release-start jgitflow:release-finish \
                            -Dgit.user=${GIT_USER} \
                            -Dgit.password=${GIT_PASSWORD} \
                            -DautoVersionSubmodules=true \
                            -DenableSshAgent=true
                    '''
                }
            }
        }
    }
}

为什么有效？
Maven会优先读取命令行传入的-D参数，这样就能把Pipeline里的凭证变量传递给jgitflow插件，完美匹配你pom里的配置项。

方案2：通过修改Maven settings.xml传递凭证（更安全） #

如果不想在命令行暴露密码（虽然Jenkins会自动屏蔽敏感输出），可以用Maven的settings.xml配置服务器凭证，然后在Pipeline里动态替换占位符：

第一步：准备带占位符的settings.xml #

<settings>
    <servers>
        <server>
            <id>git-server</id>
            <username>${git.user}</username>
            <password>${git.password}</password>
        </server>
    </servers>
</settings>

第二步：在Pipeline里替换占位符并执行Maven命令 #

pipeline {
    agent any
    stages {
        stage('Execute JGitFlow Release') {
            steps {
                withCredentials([usernamePassword(
                    credentialsId: '你的Git凭证ID',
                    usernameVariable: 'GIT_USER',
                    passwordVariable: 'GIT_PASSWORD'
                )]) {
                    // 替换settings.xml里的占位符
                    sh '''
                        sed -i "s/\\${git.user}/${GIT_USER}/g" ./settings.xml
                        sed -i "s/\\${git.password}/${GIT_PASSWORD}/g" ./settings.xml
                        // 指定修改后的settings.xml执行命令
                        mvn jgitflow:release-start jgitflow:release-finish \
                            --settings ./settings.xml \
                            -DautoVersionSubmodules=true \
                            -DenableSshAgent=true
                    '''
                }
            }
        }
    }
}

额外提示：如果你的Jenkins安装了Config File Provider插件，可以直接用插件来管理settings.xml并替换变量，比sed命令更优雅。

方案3：检查SSH Agent配置的冲突 #

你在pom里配置了<enableSshAgent>true</enableSshAgent>，如果你的Git凭证是用户名密码类型，这个配置可能会和密码凭证冲突。如果是用SSH密钥凭证，那应该改用Jenkins的sshagent步骤注入密钥，而不是用户名密码：

pipeline {
    agent any
    stages {
        stage('Execute JGitFlow Release') {
            steps {
                sshagent(['你的SSH密钥凭证ID']) {
                    sh '''
                        mvn jgitflow:release-start jgitflow:release-finish \
                            -DautoVersionSubmodules=true \
                            -DenableSshAgent=true
                    '''
                }
            }
        }
    }
}

这种情况下，jgitflow会自动使用SSH Agent里的密钥，不需要配置用户名密码。

关键注意事项 #

• 确保withCredentials的credentialsId和Jenkins里存储的凭证ID完全一致
• 在sh步骤里引用Pipeline环境变量时，要用${变量名}（Linux/macOS），Windows环境用%变量名%
• 本地开发时，依然可以通过settings.xml或命令行参数传递git.user和git.password，不影响本地构建

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