Cucumber 中 @BeforeStep 钩子的作用范围与类隔离机制详解

cucumber-jvm 的 `@beforestep` 钩子默认按扫描包全局注册，不绑定具体 step definition 类；即使某步骤仅由一个类实现，同包下所有 `@beforestep` 方法仍会被触发，这是设计使然，非 bug。

在 Cucumber-JVM 中，@BeforeStep（以及 @AfterStep）钩子的执行逻辑与普通 @Given/@When/@Then 步骤定义不同：它们不按类归属触发，而是基于 Spring 或 PicoContainer 等依赖注入容器中注册的全部钩子实例统一调用。这意味着只要 SampleStepDef1 和 SampleStepDef2 位于同一扫描包（如 src/test/java/com/example/steps/），且被 Cucumber 自动发现并实例化，其 @BeforeStep 方法就会在每个步骤执行前被无差别调用——无论当前 Gherkin 步骤实际由哪个类实现。

例如，你的场景：

Scenario: Try Epic HyperDrive
  Given just a gherkin step1 - app1
  And just a gherkin step2 - app1

虽然仅 SampleStepDef1 提供了匹配 just a gherkin step1 - app1 的实现，但只要 SampleStepDef2 被 Spring 扫描并注册为 Bean（或通过构造函数注入被 Cucumber 实例化），其 @BeforeStep 就会与 SampleStepDef1 的钩子一同执行，输出：

Before Step -- SampleStepDef1
Before Step -- SampleStepDef2  ← 非预期但符合当前设计

✅ 根本原因：Cucumber-JVM 将钩子视为“全局生命周期监听器”，而非“类内前置逻辑”。该行为已在 cucumber-jvm #1005 明确确认为 intentional design —— 钩子作用域由包级扫描路径决定，而非步骤定义类的调用上下文。

? 可行替代方案（不依赖标签过滤）：

Sider

多功能AI浏览器助手，帮助用户进行聊天、写作、阅读、翻译等

下载

1. 按类名/方法名条件判断（轻量可控）
   在钩子中检查当前执行步骤所属的 Step Definition 类：

   @BeforeStep
   public void beforeStep(Scenario scenario) {
       // 获取当前步骤的反射信息（需启用 StepEventBus 或自定义 HookContext）
       // 更实用的方式：利用 ThreadLocal + 自定义注解 + AOP（进阶）
   }

   ⚠️ 注意：Cucumber 7+ 原生不提供运行时步骤-类映射 API；若需精确控制，推荐升级至 Cucumber 7.14.0+ 并使用 StepEventBus + StepDefinitionMatch 监听（需自定义 Plugin 或 EventListener）。

2. 物理隔离：分包 + 独立 Glue 路径
   将不同业务域的 Step Definition 拆至独立包，并在 @CucumberOptions 中为不同测试指定专属 glue：

   @CucumberOptions(
       features = "src/test/resources/features/app1",
       glue = "com.example.steps.app1"  // 仅扫描 SampleStepDef1
   )

   此时 SampleStepDef2 不会被加载，其 @BeforeStep 自然不会执行。

3. 重构为组合式钩子（推荐）
   放弃 @BeforeStep，改用显式调用的工具方法，在步骤定义内部按需触发：

   public class SampleStepDef1 {
       private void beforeThisStep() {
           System.out.println("Before Step -- SampleStepDef1");
       }
   
       @Given("just a gherkin step1 - app1")
       public void just_a_gherkin_step1_app1() {
           beforeThisStep();
           // 实现逻辑
       }
   }

? 总结：@BeforeStep 的“跨类触发”不是缺陷，而是 Cucumber 对钩子语义的统一抽象——它面向的是 步骤生命周期，而非 类封装边界。如需类粒度控制，请优先采用分包隔离或显式调用模式，避免依赖未文档化的上下文绑定行为。