本文详解 cucumber 7.x 中使用 @cucumberoptions.tags 运行多标签测试的逻辑与实践，重点澄清 and 与 or 的语义差异、常见误用场景及解决方案，并提供可直接复用的配置示例。
在 Cucumber（尤其是 7.x 版本）中，通过 @CucumberOptions.tags 控制哪些 Scenario 或 Feature 被执行，是日常测试组织的关键能力。但许多开发者初次尝试运行多个标签时会遇到“无测试执行、进程静默退出（exit code 0）”的问题——这并非报错，而是 Cucumber 严格按布尔逻辑筛选后未匹配到任何有效场景所致。
? 核心原则：and 与 or 的语义完全不同
✅ tags = "@smoke or @regression"
表示：任一标签匹配即执行（并集）。适用于跨 Feature 执行不同类别的测试，例如同时运行冒烟测试和回归测试。❌ tags = "@smoke and @regression"
表示：同一 Scenario 必须同时拥有两个标签（交集）。若某 Feature 文件中一个 Scenario 只打 @smoke，另一个只打 @regression，则两者均不会被选中，最终导致零测试执行。
⚠️ 注意：and 不表示“运行所有带 @smoke 的 + 所有带 @regression 的”，这是最常见的误解根源。
✅ 正确配置示例（JUnit 4 + Cucumber 7.9.0）
假设你有两个 Feature 文件：
# src/test/resources/login.feature
@PW
Feature: Login flow
Scenario: Valid login
Given user opens login page
When user enters valid credentials
Then dashboard is displayed# src/test/resources/checkout.feature
@WM
Feature: Checkout process
Scenario: Complete purchase
Given cart contains items
When user proceeds to checkout
Then order confirmation is shown要同时运行这两个 Feature，应在 Runner 类中使用 or：
import org.junit.runner.RunWith;
import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
@RunWith(Cucumber.class)
@CucumberOptions(
features = "src/test/resources",
glue = "stepdefinitions", // ✅ 推荐明确指定包路径，避免 glue="/"（易出错）
plugin = {
"pretty",
"html:target/cucumber-reports.html",
"json:target/cucumber.json",
"junit:target/junit-cucumber-reports/Cucumber-junit.xml",
"com.aventstack.extentreports.cucumber.adapter.ExtentCucumberAdapter:"
},
tags = "@PW or @WM" // ✅ 正确：跨 Feature 匹配任一标签
)
public class TestRunner {
}? 常见错误与排查建议
| 现象 | 原因 | 解决方案 |
|---|---|---|
| 控制台输出 0 Scenarios, 0 Steps, Process finished with exit code 0 | tags = "@A and @B" 但无 Scenario 同时含两标签 | 改为 @A or @B；或确认是否真需共存标签（如 @slow and @api） |
| glue = "/" 导致 Step Definition 未绑定 | "/" 是非法包路径，Cucumber 无法扫描 | 明确指定 step definition 所在包，如 "stepdefinitions" 或 "com.example.steps" |
| 标签未生效（仍运行全部测试） | Cucumber 版本 ≥ 7.0 后，tags 不支持逗号分隔（如 "@a,@b" 已废弃） | 严格使用 and / or / not 组合，支持括号嵌套，如 "(@smoke or @sanity) and not @wip" |
? 进阶技巧：组合与排除
Cucumber 支持布尔表达式，便于精细化控制：
tags = "(@PW or @WM) and not @ignored" // 运行 PW 或 WM 标签，但排除 @ignored tags = "@api and (@prod or @staging)" // 仅运行 prod/staging 环境下的 API 测试
✅ 总结
- 多标签运行 ≠ 简单罗列，而需遵循布尔逻辑；
- or 是跨 Feature 启用多类别测试的标准方式；
- and 仅适用于对同一 Scenario 施加多重约束（如环境 + 类型）；
- 务必验证 glue 路径有效性，并优先使用语义清晰的包名而非通配符；
- 建议在 CI/CD 中通过 Maven 命令动态传参，提升灵活性：
mvn test -Dcucumber.filter.tags="@PW or @WM"
掌握标签逻辑，是构建可维护、可伸缩 Cucumber 测试套件的第一步。
