如何在 Cucumber 中按名称跳过指定场景（无需参数注入）

如何在 cucumber 中按名称跳过指定场景（无需参数注入）

在 Cucumber-JVM 中，钩子方法（如 @BeforeStep、@Before）不支持从正则表达式中提取并注入自定义参数（如 String name）。你尝试的写法：

@Given("^skip the next scenario named \"(.*)\"$")
@BeforeStep
public void before(Scenario scenario, String name) { ... }

是无效的——@BeforeStep 方法签名仅允许 Scenario 类型参数，Cucumber 不会将正则捕获组映射到额外形参。该 @Given 步骤定义本身也逻辑矛盾：@Given 是步骤定义，而 @BeforeStep 是钩子，二者不可混用，且钩子无法绑定 Gherkin 步骤的参数。

✅ 正确解法：使用 Cucumber 运行时过滤机制，通过 @CucumberOptions(name = "...") 指定正则表达式，在测试执行前就排除目标场景，而非在运行中“跳过”。

✅ 推荐方案：用 name 过滤器 + 负向先行断言（Negative Lookahead）

假设你的 .feature 文件如下：

零一万物开放平台

零一万物大模型开放平台

下载

Feature: Basic Arithmetic

  Background: A Calculator
    Given a calculator I just turned on

  Scenario: Addition
    When I add 4 and 5
    Then the result is 9

  Scenario: Another Addition
    When I add 4 and 7
    Then the result is 11

你想跳过 Addition 场景，只运行 Another Addition，可创建一个 JUnit 运行类：

package io.cucumber.examples.calculator;

import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
import org.junit.runner.RunWith;

@RunWith(Cucumber.class)
@CucumberOptions(
    name = "^(?!Addition).*$",  // 匹配所有不以 "Addition" 开头的场景名
    features = "src/test/resources/features",
    glue = "io.cucumber.examples.calculator.steps"
)
public class RunCucumberTest {
}

? 正则说明：

• ^ 表示行首，$ 表示行尾；
• (?!Addition) 是负向先行断言：要求当前位置之后不能紧接 "Addition"；
• .* 匹配任意字符（除换行符）零次或多次；
  → 整体效果：仅匹配场景名不以 "Addition" 开头的场景（如 "Another Addition" 符合，"Addition" 被排除）。

⚠️ 注意事项

• name 过滤作用于 场景（Scenario）名称，即 .feature 文件中 Scenario: 后的文本（含前后空格），建议用 .trim() 在正则中处理（如 "^(?!\\s*Addition\\s*$).*$" 更健壮）；
• 若需动态跳过（如基于环境变量），可结合 Maven Surefire 的 或 System.getProperty() 构建动态正则；
• ❌ 不要尝试在钩子中调用 Assume.assumeTrue(false) 模拟跳过——这会导致测试失败（AssumptionViolatedException），而非静默跳过；真正的“跳过”必须发生在执行前过滤阶段。

✅ 总结

通过合理设计正则表达式，你可灵活实现“包含/排除特定场景”，这是 Cucumber 官方推荐的、生产就绪的场景控制方式。