如何在 Cucumber 中按名称过滤并跳过特定场景_技术教程

本文介绍如何在 cucumber-jvm 中通过正则表达式精准匹配场景名称来跳过指定测试，避免在步骤定义中错误注入参数（如将 `scenario` 与自定义字符串混用），并提供可直接运行的配置方案。

在 Cucumber 中，不能在 @BeforeStep 或 @Given 等钩子/步骤方法中同时声明 Scenario 和正则捕获的字符串参数（如 String name）。这是因为 Cucumber 的参数绑定机制仅支持从 Gherkin 行中提取匹配组，并自动注入到步骤定义方法（即带 @Given/@When/@Then 的方法）中；而 @BeforeStep、@Before 等钩子方法不支持正则捕获参数绑定——它们只接收固定类型的上下文对象（如 Scenario、ExtentTest 等），无法解析 "(.*)" 捕获内容。

因此，你原始代码：

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

会编译失败或运行时报 ParameterResolutionException：Cucumber 无法为钩子方法解析正则捕获组。

✅ 正确做法是：放弃在钩子中“动态传参”，改用 Cucumber 内置的 --name 过滤机制（支持正则）在运行时跳过目标场景。

✅ 推荐方案：使用 @CucumberOptions(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，可在测试启动类中配置：

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 参数支持完整正则，但需注意 Ja
va 字符串转义（如写 \\d+ 表示数字）；
若需跳过多个名称，可用 | 构建多选分支：name = "^(?!Addition|Subtraction|Division).*$"；
此方式在测试执行前过滤，比运行时 Assume.assumeTrue(false) 更高效、更清晰，且避免污染步骤逻辑；
不要尝试在 @Before/@BeforeStep 中注入正则参数——这是 Cucumber 设计限制，强行绕过会导致不可维护的 hack。

✅ 总结

参数传递应严格遵循 Cucumber 的生命周期约定：
? 步骤定义方法（@Given 等）→ 支持正则捕获参数；
? 钩子方法（@BeforeStep 等）→ 仅支持固定上下文对象（Scenario, ExtentTest, WebDriver 等），不支持正则参数绑定。
真正健壮、可维护的“跳过场景”方案，是利用 @CucumberOptions(name = "...") 在框架层完成过滤——简洁、标准、零侵入。