如何在不抛出java.lang.AssertionError的情况下使Cucumber场景失败

要让TestNG断言失败后，控制台、日志和HTML报告只显示自定义信息，而非带java.lang.AssertionError的完整栈信息，可以通过以下几种方式实现：

1. 封装自定义断言类，抛出精简异常 #

自己封装断言方法，抛出仅包含自定义信息的异常，同时重写栈填充方法减少冗余输出：

import java.util.Objects;

public class CustomAssert {
    // 示例：自定义相等断言
    public static void assertEquals(Object actual, Object expected, String customMsg) {
        if (!Objects.equals(actual, expected)) {
            throw new CustomAssertException(customMsg);
        }
    }

    // 自定义异常类，仅保留自定义信息，精简栈追踪
    static class CustomAssertException extends RuntimeException {
        public CustomAssertException(String message) {
            super(message);
        }

        @Override
        public synchronized Throwable fillInStackTrace() {
            // 禁用栈追踪填充，减少输出内容
            return this;
        }
    }
}

在步骤定义中使用这个CustomAssert代替TestNG原生的Assert类，Cucumber捕获到CustomAssertException时，就只会输出你定义的自定义信息，不会附带AssertionError前缀。

2. 利用Cucumber钩子（Hook）修改失败信息 #

通过@AfterStep钩子捕获场景失败事件，替换异常信息：

import io.cucumber.java.AfterStep;
import io.cucumber.java.Scenario;

public class CucumberHooks {
    @AfterStep
    public void customizeFailureMessage(Scenario scenario) {
        if (scenario.isFailed()) {
            scenario.getFailureCause().ifPresent(cause -> {
                if (cause instanceof AssertionError) {
                    // 提取原断言的自定义信息，替换为仅含该信息的异常
                    scenario.setFailureCause(new RuntimeException(cause.getMessage()));
                }
            });
        }
    }
}

这个钩子会在每个步骤执行后触发，若步骤失败且原异常是AssertionError，就将失败原因替换为仅含自定义信息的RuntimeException，这样报告和控制台只会显示你设置的信息。

3. 实现Cucumber事件监听器自定义输出 #

实现Cucumber的EventListener接口，监听步骤失败事件，自定义错误信息的输出格式：

import io.cucumber.plugin.EventListener;
import io.cucumber.plugin.event.EventPublisher;
import io.cucumber.plugin.event.TestStep;
import io.cucumber.plugin.event.TestStepFinished;

public class CustomErrorListener implements EventListener {
    @Override
    public void setEventPublisher(EventPublisher publisher) {
        publisher.registerHandlerFor(TestStepFinished.class, this::handleTestStepFinished);
    }

    private void handleTestStepFinished(TestStepFinished event) {
        if (event.getResult().isFailed()) {
            Throwable cause = event.getResult().getError();
            if (cause instanceof AssertionError) {
                // 这里可以自定义输出逻辑，比如直接打印自定义信息到控制台
                System.err.println("Step failed: " + cause.getMessage());
                // 若要修改报告中的信息，还需结合Cucumber的报告扩展点
            }
        }
    }
}

然后在Cucumber运行配置中注册这个监听器，就能自定义控制台的错误输出格式。

4. 结合TestNG监听器修改错误信息 #

实现TestNG的ITestListener接口，在测试失败时修改异常信息，再传递给Cucumber：

import org.testng.ITestListener;
import org.testng.ITestResult;

public class TestNGCustomListener implements ITestListener {
    @Override
    public void onTestFailure(ITestResult result) {
        Throwable throwable = result.getThrowable();
        if (throwable instanceof AssertionError) {
            // 替换原异常为仅含自定义信息的异常
            result.setThrowable(new RuntimeException(throwable.getMessage()));
        }
    }
}

将这个监听器注册到TestNG的运行配置中，TestNG会在测试失败时修改异常，Cucumber最终拿到的就是处理后的精简信息。

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