如何将Jenkins凭证传递给Maven Surefire插件执行集成测试

根因分析 #

1. POM配置存在低级错误：systemPropertyVariables段下test_password的标签误写为test_username，导致密码配置完全失效
2. Maven默认不会直接读取Shell环境变量作为自身属性，你之前直接写${TEST_USERNAME}的引用方式错误，需要添加env.前缀访问系统环境变量
3. 同时配置argLines和systemPropertyVariables存在参数冲突风险，重复传递同一属性会导致不可预期的覆盖问题

修复步骤 #

1. 修正POM中Surefire插件的配置，仅保留systemPropertyVariables结构化配置，使用${env.变量名}格式引用Jenkins导出的环境变量：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.22.2</version>
    <configuration>
        <systemPropertyVariables>
            <test_username>${env.TEST_USERNAME}</test_username>
            <test_password>${env.TEST_PASSWORD}</test_password>
        </systemPropertyVariables>
    </configuration>
</plugin>

2. Jenkins流水线中不需要在Maven命令行追加任何参数，直接调用即可：

withCredentials([
    [
        $class: 'UsernamePasswordMultiBinding', 
        credentialsId: 'TEST', 
        usernameVariable: 'TEST_USERNAME', 
        passwordVariable: 'TEST_PASSWORD'
    ]
]) {
    sh 'mvn clean install'
}

3. 确保Jenkins代理的系统大小写敏感规则匹配变量名定义：Linux环境下变量名区分大小写，Windows环境不区分，这也是你本地运行正常但Jenkins运行失败的常见诱因

补充说明 #

你遇到的entityManagerFactory初始化报错本质是数据库凭证无效导致的连接失败，不是配置时机问题，修正配置后即可恢复正常。如果需要进一步外部化配置，可结合Maven Properties插件读取外置配置文件，敏感凭证依然通过Jenkins环境变量注入即可，不需要存入代码仓库。

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