使用JUnit作为运行器时，Cucumber JVM抛异常为何不标记步骤失败？

我之前也碰到过一模一样的情况，大概率是版本兼容性、步骤定义的异常处理，或者配置变更导致的，咱们一步步来排查：

1. 先检查依赖版本的兼容性 #

Cucumber JVM和JUnit的版本匹配很关键，尤其是从旧版本升级到新版本（比如Cucumber 6→7或者JUnit 4→5）时，异常处理逻辑可能有变化：

• 如果用JUnit 5的@Cucumber运行器，要确保cucumber-junit-platform-engine、cucumber-java以及JUnit Jupiter的版本完全一致，避免版本冲突。
• 如果还在使用JUnit 4的@RunWith(Cucumber.class)，也要保证cucumber-junit和其他Cucumber依赖版本统一。

2. 检查步骤定义里的异常处理 #

这是最常见的原因：你是不是在步骤方法里捕获了运行时异常，但没有重新抛出？Cucumber只会把未被捕获的异常（或者明确抛出的异常）判定为步骤失败，如果异常被吞掉了，它就会认为步骤执行完成，标记为PASSED。

举个错误和正确的写法对比：

// ❌ 错误：吞掉了异常，Cucumber感知不到
@Given("用户执行某个操作")
public void userPerformsAction() {
    try {
        // 这里会抛出RuntimeException的代码
        riskyOperation();
    } catch (RuntimeException e) {
        // 只记录日志但不抛出，Cucumber以为步骤正常结束
        log.error("操作出错了", e);
    }
}

// ✅ 正确：要么不捕获，要么重新抛出异常
@Given("用户执行某个操作")
public void userPerformsAction() {
    // 方式1：直接执行，让异常自然抛出
    riskyOperation();

    // 方式2：捕获后包装成Cucumber能识别的异常抛出
    try {
        riskyOperation();
    } catch (RuntimeException e) {
        throw new CucumberException("步骤执行失败：" + e.getMessage(), e);
    }
}

3. 检查JUnit运行器的配置 #

• 如果用JUnit 4的@RunWith(Cucumber.class)，对比之前的配置，有没有修改过glue路径、features路径，或者添加了特殊的plugin参数？错误的配置可能导致Cucumber无法正确捕获步骤中的异常。
• 如果用JUnit 5的@Cucumber，检查是否设置了filter或者其他自定义参数，有没有干扰到异常的判定逻辑。

4. 排查自定义报告插件的问题 #

如果你用了第三方的报告插件，有些插件可能对异常的处理逻辑和默认行为不同，导致显示错误。可以暂时去掉自定义插件，改用Cucumber默认的html或者pretty插件生成报告，看看步骤状态是否正常。

5. 确认是否是Cucumber的行为变更 #

如果是最近升级了Cucumber版本，要注意官方文档里的行为变更：比如Cucumber 7+对异步代码的异常处理更严格，如果你的步骤里有异步操作，需要确保异常被正确传递到主线程，否则Cucumber可能捕获不到。

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