如何在运行时获取当前执行的Cucumber步骤名称？

你提到的StepDefinitionMatch确实持有当前执行的Step实例——从你给出的构造函数里能看到this.step = step;，这个Step对象就包含了你需要的步骤文本。下面给你几种在运行时轻松获取它的实用方法：

方法1：使用Cucumber的@BeforeStep/@AfterStep钩子（推荐，Cucumber 6+） #

这是最简单直接的方式，Cucumber从6.x版本开始支持步骤级钩子，你可以直接在钩子方法中注入Step对象来获取步骤名称：

import io.cucumber.java.BeforeStep;
import io.cucumber.java.Step;

public class StepHooks {

    @BeforeStep
    public void beforeStep(Step currentStep) {
        // 获取步骤文本（就是你在feature文件里写的步骤内容）
        String stepName = currentStep.getText();
        // 根据步骤名称执行你的逻辑
        if (stepName.contains("用户登录系统")) {
            // 执行登录相关的特定操作
        }
    }
}

这个方法无需修改底层组件，完全利用Cucumber原生API，最适合大多数场景。

方法2：通过自定义StepDefinitionMatch扩展（底层定制） #

如果你需要更底层的控制，比如在步骤匹配时就获取信息，可以通过Cucumber的SPI扩展机制自定义StepDefinitionMatch：

1. 首先创建一个自定义的StepDefinitionMatch类，继承原类并添加你需要的逻辑：

public class CustomStepDefinitionMatch extends StepDefinitionMatch {

    public CustomStepDefinitionMatch(List<Argument> arguments, StepDefinition stepDefinition, String featurePath, Step step, LocalizedXStreams localizedXStreams) {
        super(arguments, stepDefinition.getLocation(false));
        this.stepDefinition = stepDefinition;
        this.featurePath = featurePath;
        this.step = step;
        this.localizedXStreams = localizedXStreams;
        
        // 在这里就可以获取步骤名称并执行操作
        String stepName = step.getText();
        handleStepSpecificLogic(stepName);
    }

    private void handleStepSpecificLogic(String stepName) {
        // 你的自定义逻辑
    }
}

2. 然后创建一个StepDefinitionMatcher的实现，返回你的自定义StepDefinitionMatch：

public class CustomStepDefinitionMatcher extends DefaultStepDefinitionMatcher {

    @Override
    public StepDefinitionMatch matchStep(Step step, CucumberBackend backend) {
        // 这里复用原逻辑，替换为自定义的StepDefinitionMatch
        List<Argument> arguments = ...; // 原匹配逻辑获取参数
        StepDefinition stepDefinition = ...; // 获取匹配到的步骤定义
        String featurePath = ...; // 获取feature路径
        LocalizedXStreams localizedXStreams = ...; // 获取本地化流
        
        return new CustomStepDefinitionMatch(arguments, stepDefinition, featurePath, step, localizedXStreams);
    }
}

3. 最后在src/main/resources/META-INF/services/io.cucumber.core.backend.StepDefinitionMatcher文件中注册你的实现：

com.yourpackage.CustomStepDefinitionMatcher

这种方式适合需要深度定制步骤匹配流程的场景，但相对复杂一些。

方法3：使用Cucumber EventListener监听步骤事件 #

如果你想在全局监听所有步骤的执行，可以实现EventListener接口，监听TestStepStarted事件：

import io.cucumber.plugin.EventListener;
import io.cucumber.plugin.event.EventPublisher;
import io.cucumber.plugin.event.TestStepStarted;
import io.cucumber.plugin.event.TestStep;
import io.cucumber.core.gherkin.Step;

public class StepListener implements EventListener {

    @Override
    public void setEventPublisher(EventPublisher publisher) {
        publisher.registerHandlerFor(TestStepStarted.class, this::onTestStepStarted);
    }

    private void onTestStepStarted(TestStepStarted event) {
        TestStep testStep = event.getTestStep();
        // 判断是否是Gherkin步骤
        if (testStep instanceof io.cucumber.core.gherkin.Step) {
            Step step = (Step) testStep;
            String stepName = step.getText();
            // 执行你的特定操作
        }
    }
}

然后在运行Cucumber时注册这个监听器，比如通过@CucumberOptions：

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

@RunWith(Cucumber.class)
@CucumberOptions(
        plugin = {"com.yourpackage.StepListener"}
)
public class RunCucumberTests {
}

从你提供的调用栈来看，StepDefinitionMatch是在步骤匹配时创建的，上面的方法都能帮你在运行时拿到步骤名称。推荐优先用方法1，最简洁高效。

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