Serenity BDD+Java+Gradle环境中Cucumber标签不生效的求助

以下是针对标签过滤失效问题的具体解决步骤：

1. 确保Gradle测试任务正确传递系统参数 #

在build.gradle（或build.gradle.kts）中显式配置测试任务，保证外部传入的JVM参数能传递到测试进程：

Groovy语法： #

test {
    // 传递所有JVM系统参数到测试任务
    systemProperties System.getProperties()
    
    // 也可单独指定参数（可选，更严谨）
    // systemProperty 'environment', System.getProperty('environment', 'sandbox')
    // systemProperty 'cucumber.filter.tags', System.getProperty('cucumber.filter.tags', '')
}

Kotlin语法： #

tasks.test {
    systemProperties(System.getProperties())
    
    // 也可单独指定参数
    // systemProperty("environment", System.getProperty("environment", "sandbox"))
    // systemProperty("cucumber.filter.tags", System.getProperty("cucumber.filter.tags", ""))
}

2. 清理测试类中的硬编码标签配置 #

检查你的TestSuiteClass，如果@CucumberOptions中硬编码了tags属性，会覆盖外部参数，需修改为动态读取系统参数或留空：

import net.serenitybdd.cucumber.CucumberWithSerenity;
import org.junit.runner.RunWith;
import io.cucumber.junit.CucumberOptions;

@RunWith(CucumberWithSerenity.class)
@CucumberOptions(
        features = "src/test/resources/features",
        glue = "your.step.definitions.package",
        // 动态读取系统参数，无参数时默认不过滤
        tags = "${cucumber.filter.tags}"
)
public class TestSuite {
}

若使用Cucumber 7.x+版本，@CucumberOptions中的tags已被filter.tags替代，可改为：

filterTags = "${cucumber.filter.tags}"

3. 正确配置IntelliJ的Gradle运行任务 #

确保运行的是Gradle的test任务，而非直接运行测试类：

• 打开IntelliJ运行配置，选择Gradle类型
• 在Tasks输入框填写test
• 在VM options中添加参数：-Denvironment=sandbox -Dcucumber.filter.tags="@sprint-13"
• 运行该配置，不要直接右键测试类执行

4. 验证参数是否传递成功 #

在任意步骤定义类中添加打印代码，确认参数已到达测试进程：

System.out.println("当前生效的标签过滤规则：" + System.getProperty("cucumber.filter.tags"));

运行后查看控制台，若输出@sprint-13则参数传递正常，否则检查Gradle配置和运行配置。

5. 适配Serenity/Cucumber版本 #

• Serenity 3.x+ 配合 Cucumber 7.x：使用-Dcucumber.filter.tags="@sprint-13"
• 旧版本（Serenity 2.x + Cucumber 6.x及以下）：使用-Dcucumber.options="--tags @sprint-13"，同时测试类@CucumberOptions对应使用tags属性。

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