如何在cucumber-jvm第一个场景失败时跳过所有后续场景

嘿，这个需求挺实用的！尤其是在需要先做环境校验的测试流程里，能帮你省不少不必要的执行时间。我来给你一步步讲怎么实现：当第一个环境检测场景失败时，自动跳过剩下所有场景。

核心思路 #

我们可以借助Cucumber的钩子（Hooks） + 全局标志位来实现：

1. 用一个静态变量来标记是否允许后续场景执行
2. 在每个场景执行前的@Before钩子中检查这个标志，若标记为"禁止执行"则跳过当前场景
3. 在第一个环境检测场景执行后的@After钩子中，判断该场景是否失败，若失败则把标志位设为"禁止执行"

具体实现步骤 #

1. 创建全局执行控制类 #

先写一个简单的工具类，用来存储全局执行状态：

public class TestExecutionController {
    // 静态标志位：默认允许所有场景执行
    public static boolean allowExecution = true;
}

2. 编写场景前置跳过钩子 #

这个钩子会在每个场景执行前触发，检查标志位决定是否跳过：

import io.cucumber.java.Before;
import io.cucumber.java.Scenario;

public class SkipScenariosHook {

    @Before
    public void beforeScenario(Scenario scenario) {
        // 如果标志位为false，直接跳过当前场景
        if (!TestExecutionController.allowExecution) {
            scenario.skip("跳过原因：环境检测场景失败，终止后续测试执行");
        }
    }
}

3. 编写环境检测场景的后置钩子 #

给第一个环境检测场景加个专属标签（比如@env-check），然后写一个只针对这个标签的@After钩子，用来更新标志位：

import io.cucumber.java.After;
import io.cucumber.java.Scenario;

public class EnvCheckHook {

    @After("@env-check")
    public void afterEnvCheckScenario(Scenario scenario) {
        // 如果环境检测场景失败，将全局标志位设为false
        if (scenario.isFailed()) {
            TestExecutionController.allowExecution = false;
            System.out.println("⚠️ 环境检测场景失败，将跳过所有后续测试场景");
        }
    }
}

4. 给第一个场景添加专属标签 #

在你的feature文件里，给环境检测的场景加上@env-check标签，并且确保它是第一个执行的场景：

Feature: 系统功能测试
  @env-check
  Scenario: 检测页面加载时间和环境可用性
    Given 打开目标系统首页
    Then 页面加载时间不超过5秒
    And 核心环境服务状态均为正常

  Scenario: 功能A测试
    Given 用户登录系统
    When 执行功能A操作
    Then 操作结果符合预期

  # 剩下的6个场景...

5. 配置CucumberOptions #

确保你的测试运行类（TestRunner）的glue参数包含钩子类所在的包，这样Cucumber才能扫描到这些钩子：

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

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features",
    glue = {"your.step.definitions.package", "your.hooks.package"}, // 替换成你实际的包路径
    plugin = {"pretty", "html:target/cucumber-reports"}
)
public class TestRunner {
}

额外注意事项 #

• 执行顺序：Cucumber默认按feature文件的顺序执行场景，所以务必把@env-check的场景放在所有场景的最前面。如果需要更严格的顺序控制，可以在CucumberOptions里添加order = Order.ASCENDING（不过新版本Cucumber推荐手动调整文件/场景顺序）。
• 多线程并行：如果你的测试是多线程并行执行的，静态变量会有线程安全问题，这时候可以把静态变量换成ThreadLocal<Boolean>来保证线程隔离。
• 报告显示：被跳过的场景会在Cucumber报告里标记为skipped，并且会显示我们设置的跳过原因，方便后续排查。

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