如何获取Cucumber测试中当前正在执行的Step步骤名称

Cucumber的Scenario对象本身没有直接暴露当前执行步骤的接口，你可以根据你使用的Cucumber版本选择对应实现方案：

适用Cucumber 6.x及以上版本 #

通过@BeforeStep钩子配合线程隔离的计数器实现，代码如下：

import io.cucumber.java.Before;
import io.cucumber.java.BeforeStep;
import io.cucumber.java.Scenario;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class StepLogHook {
    private static final Logger logger = LoggerFactory.getLogger(StepLogHook.class);
    // 线程隔离的步骤计数器，避免并行执行时计数错乱
    private final ThreadLocal<Integer> currentStepIndex = ThreadLocal.withInitial(() -> 0);
    private final ThreadLocal<Scenario> currentScenario = new ThreadLocal<>();

    @Before(order = 2)
    public void logScenarioStarting(Scenario scenario) {
        currentScenario.set(scenario);
        // 每个场景开始前重置步骤计数器
        currentStepIndex.set(0);
        logger.debug("Starting scenario {}.", scenario.getName());
    }

    @BeforeStep
    public void logStepStarting() {
        Scenario scenario = currentScenario.get();
        Integer stepIndex = currentStepIndex.get();
        // 获取当前步骤的文本内容
        String stepText = scenario.getTestSteps().get(stepIndex).getText();
        logger.debug("Starting step: {}", stepText);
        // 计数器+1，为下一个步骤做准备
        currentStepIndex.set(stepIndex + 1);
    }
}

适用Cucumber 5.x及更低版本 #

低版本Scenario未公开getTestSteps()方法，需要通过注册Cucumber事件监听器实现：

import io.cucumber.plugin.EventListener;
import io.cucumber.plugin.event.EventPublisher;
import io.cucumber.plugin.event.TestStepStarted;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class StepLogPlugin implements EventListener {
    private static final Logger logger = LoggerFactory.getLogger(StepLogPlugin.class);

    @Override
    public void setEventPublisher(EventPublisher publisher) {
        publisher.registerHandlerFor(TestStepStarted.class, event -> {
            // 过滤掉钩子步骤，只捕获用户定义的Gherkin步骤
            if (event.getTestStep().isPickleStep()) {
                String stepText = event.getTestStep().getPickleStep().getText();
                logger.debug("Starting step: {}", stepText);
            }
        });
    }
}

实现后需要在Cucumber启动配置中指定该插件，示例：

@CucumberOptions(
    plugin = "com.yourpackage.StepLogPlugin", // 替换为你实际的插件类路径
    features = "src/test/resources/features"
)

注意事项 #

• 并行执行场景时必须使用ThreadLocal存储中间状态，避免不同场景的执行数据互相干扰
• 如需获取步骤前缀关键字（Given/When/Then等），可调用对应Step对象的getKeyword()方法获取
• Background定义的公共步骤也会被正常捕获

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