如何在Java集成测试中获取Jenkins流水线设置的环境变量？

哎，这个问题我之前也碰到过！Jenkins里设置的环境变量没法直接在Java测试里拿到，核心原因是Jenkins的环境变量不会自动传递给Maven启动的测试JVM进程，得咱们手动做些配置才行，给你几个靠谱的解决办法：

方法一：在Jenkins流水线中显式传递环境变量给Maven #

不管你用声明式还是脚本式流水线，都可以通过以下两种方式把变量传给Maven进程：

1.1 用withEnv包裹Maven命令 #

把需要的环境变量明确注入到shell子进程中，这样Maven就能拿到：

// 脚本式流水线示例，声明式可直接放在stage的steps块内
env.'appium.app.branch' = branch // 保留你原来的变量设置

stage('Run Integration Tests') {
    steps {
        withEnv(["appium.app.branch=${env.'appium.app.branch'}"]) {
            sh 'mvn verify'
        }
    }
}

1.2 直接在shell命令里前置环境变量 #

这种方式更简洁，不用额外的包裹块：

stage('Run Integration Tests') {
    steps {
        sh "appium.app.branch=${env.'appium.app.branch'} mvn verify"
    }
}

做完这一步，Java测试里用System.getenv("appium.app.branch")就能拿到值了。

方法二：通过Maven系统属性传递（更稳妥） #

如果担心环境变量的兼容性问题（比如部分系统对带点的变量名支持不佳），可以把Jenkins变量转为Maven的系统属性，Java里用System.getProperty()获取：

2.1 Jenkins流水线中传递系统属性 #

stage('Run Integration Tests') {
    steps {
        sh "mvn verify -Dappium.app.branch=${env.'appium.app.branch'}"
    }
}

2.2 Java代码中获取 #

String branch = System.getProperty("appium.app.branch");

方法三：配置Maven Surefire插件兜底 #

如果上面两种方式还是不行，大概率是Maven的Surefire插件（负责运行测试的核心插件）没把环境变量传递给测试JVM。可以在项目的pom.xml里添加这段配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.5</version> <!-- 替换成你项目使用的插件版本 -->
            <configuration>
                <!-- 把环境变量转为系统属性传给测试JVM -->
                <systemPropertyVariables>
                    <appium.app.branch>${env.appium.app.branch}</appium.app.branch>
                </systemPropertyVariables>
                <!-- 或者直接传递环境变量到测试进程 -->
                <environmentVariables>
                    <appium.app.branch>${env.appium.app.branch}</appium.app.branch>
                </environmentVariables>
            </configuration>
        </plugin>
    </plugins>
</build>

小提示：变量名尽量用下划线格式 #

如果带点的变量名还是出现兼容问题，建议改成下划线形式，比如APPIUM_APP_BRANCH，兼容性更好：

• Jenkins里设置：env.APPIUM_APP_BRANCH = branch
• Java里获取：System.getenv("APPIUM_APP_BRANCH")

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