Java/Spring Boot 2中通过环境变量配置Cucumber的features路径

可以通过环境变量动态指定Cucumber的features路径，核心是避开Java注解参数必须为编译期常量的限制，改用运行时参数传递路径。下面是具体实现步骤：

核心问题分析 #

你之前直接在@CucumberOptions中使用${MY_ENVIRONMENT_VARIABLE}的方式不可行，因为Java注解的参数必须是编译期常量，环境变量属于运行时动态值，无法在编译阶段解析，导致路径错误。

方案一：优化Gradle测试任务配置（推荐） #

1. 调整TestAcceptance类 #

移除@CucumberOptions中的features配置，将公共配置（如plugin、tags、glue）保留，动态路径通过Gradle参数传递：

@RunWith(Cucumber.class)
@CucumberOptions(
        plugin = "pretty",
        tags = "~@ignore",
        glue = "acceptance.steps"
)
public class TestAcceptance {
}

2. 修改Gradle的acceptanceTest任务 #

通过JVM参数传递动态生成的features路径，优先使用classpath路径（更可靠，避免文件系统路径依赖）：

sourceSets {
    acceptanceTest {
        java {
            compileClasspath += sourceSets.main.output
            runtimeClasspath += sourceSets.main.output
            srcDirs = ['src/acceptance-test/java']
        }
        resources.srcDir file('src/acceptance-test/resources')
    }
}

task acceptanceTest(type: Test) {
    testClassesDirs = sourceSets.acceptanceTest.output.classesDirs
    classpath = sourceSets.acceptanceTest.runtimeClasspath
    
    // 获取环境变量，默认值设为开发环境（可根据需求调整）
    def testEnv = System.getenv("MY_ENVIRONMENT_VARIABLE") ?: "dev"
    // 用classpath前缀指向对应环境的feature目录
    def featuresPath = "classpath:/${testEnv}/"
    
    options.jvmArgs = [
        "-Dcucumber.options=--plugin pretty --tags ~@ignore --glue acceptance.steps --features ${featuresPath}"
    ]
    
    // 若使用JUnit 5，添加此配置（Spring Boot 2兼容JUnit 4/5）
    useJUnitPlatform()
}

test {
    useJUnitPlatform()
    jvmArgs "-Xms2g", "-Xmx2g", "-XX:+DisableExplicitGC"
    finalizedBy jacocoTestReport
}

3. 目录结构要求 #

确保你的资源目录按环境划分，结构如下：

src/acceptance-test/resources/
├── dev/
│   ├── *.feature
│   └── acceptance-test.properties
├── test/
│   ├── *.feature
│   └── acceptance-test.properties
└── prod/
    ├── *.feature
    └── acceptance-test.properties

方案二：使用Cucumber程序化API（灵活扩展场景） #

如果需要更复杂的动态逻辑，可通过Cucumber的CLI API手动启动测试：

public class TestAcceptanceRunner {
    public static void main(String[] args) {
        // 读取环境变量，设置默认值
        String testEnv = System.getenv("MY_ENVIRONMENT_VARIABLE") != null ? System.getenv("MY_ENVIRONMENT_VARIABLE") : "dev";
        String featuresPath = "classpath:/" + testEnv + "/";
        
        // 构造Cucumber运行参数
        String[] cucumberArgs = {
                "--plugin", "pretty",
                "--tags", "~@ignore",
                "--glue", "acceptance.steps",
                "--features", featuresPath
        };
        
        // 启动Cucumber测试
        cucumber.api.cli.Main.run(cucumberArgs, Thread.currentThread().getContextClassLoader());
    }
}

然后在Gradle中配置任务运行这个main类：

task runAcceptanceTest(type: JavaExec) {
    classpath = sourceSets.acceptanceTest.runtimeClasspath
    mainClass = "acceptance.TestAcceptanceRunner"
    def testEnv = System.getenv("MY_ENVIRONMENT_VARIABLE") ?: "dev"
    environment "MY_ENVIRONMENT_VARIABLE", testEnv
}

运行测试 #

执行测试时通过环境变量指定目标环境：

# Linux/Mac
MY_ENVIRONMENT_VARIABLE=test ./gradlew acceptanceTest

# Windows（PowerShell）
$env:MY_ENVIRONMENT_VARIABLE="test"; ./gradlew acceptanceTest

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