Cucumber-TestNG项目中如何通过命令行正确传递标签参数

核心问题 #

你遇到的情况是因为Cucumber中命令行指定的标签与Runner类@CucumberOptions里配置的标签是逻辑或（OR）关系。从你的Runner配置来看，应该是在@CucumberOptions中写了类似tags = {"@sanity, @smoke"}的配置，这就导致不管命令行传什么标签，最终执行条件都会变成@sanity OR @smoke，因此会跑满12个场景。

解决方法 #

1. 移除Runner类中的固定标签配置（推荐） #

直接删掉@CucumberOptions里的tags属性，让标签完全由命令行参数控制。修改后的Runner类示例：

@CucumberOptions(
    features = "src/test/resources/features",
    glue = "你的step定义包路径",
    plugin = {"pretty", "html:target/cucumber-reports.html"}
    // 移除tags配置项
)
public class TestRunner extends AbstractTestNGCucumberTests {
}

之后执行对应命令即可精准跑指定标签的用例：

# 只跑@sanity场景
./gradlew -i test -Denv=release -Dcucumber.filter.tags="@sanity"

# 只跑@smoke场景
./gradlew -i test -Denv=release -Dcucumber.filter.tags="@smoke"

2. 保留默认配置的兼容方案 #

如果需要Runner类保留默认执行逻辑（比如默认跑全部37个regression用例），可以把默认标签设为"not @ignore"（给不需要默认执行的用例加@ignore标签），或者命令行用精确表达式强制过滤：

# 强制只跑@sanity，排除@smoke
./gradlew -i test -Denv=release -Dcucumber.filter.tags="@sanity and not @smoke"

不过这种只是临时 workaround，第一种方法更彻底。

3. 确认命令行参数规范 #

Cucumber 6及以上版本推荐使用cucumber.filter.tags参数，旧的cucumber.options已被废弃，尽量避免使用。同时注意参数格式，标签不需要额外加引号（比如-Dcucumber.filter.tags=@sanity也可正常生效）。

补充：Cucumber标签逻辑规则 #

• 逗号（,）= 逻辑或：@sanity, @smoke → 执行任意一个标签的用例
• 空格 = 逻辑与：@sanity @regression → 执行同时拥有两个标签的用例
• not = 排除：@sanity not @smoke → 执行@sanity但排除@smoke的用例

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