Cucumber测试步骤定义无法识别，报‘Undefined step reference’求助

以下是针对该问题的排查和解决步骤：

1. 修正Runner类的Glue参数格式 #

Glue参数需要填写包的全限定名，而非文件系统路径。比如你的Step定义类在com.yourproject.stepdefinitions包下，glue就写这个包名，不要用src/test/java/stepdefinitions这类路径。
正确的Runner类示例：

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

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features",
    glue = "com.yourproject.stepdefinitions", // 此处为包名，不是文件路径
    plugin = {"pretty", "html:target/cucumber-reports"}
)
public class TestRunner {}

2. 校验Step定义与Feature步骤的匹配度 #

• 确保Step类里的方法注解（@Given/@When/@Then）后的字符串，和Feature文件里的步骤文本完全一致，包括空格、标点符号（注意区分中英文符号）。
• 示例：如果Feature里是Given 用户进入首页，Step定义必须是：

@Given("用户进入首页")
public void userEntersHomePage() {
    // 业务逻辑实现
}

3. 检查编译目录与类路径 #

重建项目后IDE能识别但运行时找不到，大概率是编译后的Step类没在测试类路径里：

• 确认Maven/Gradle的编译配置，src/test/java下的类是否被正确编译到target/test-classes（Maven）或build/classes/test（Gradle）目录。
• 运行测试时，确保测试运行器（JUnit/TestNG）能加载到上述目录下的Step类。

4. 统一Cucumber依赖版本 #

所有Cucumber相关依赖（cucumber-java、cucumber-junit、cucumber-core等）必须版本一致，版本不匹配会导致运行时扫描不到Step定义。
Maven依赖示例：

<dependencies>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

5. 清除缓存并重新构建 #

IDE或编译缓存可能导致异常：

• 用构建工具执行清理命令：Maven运行mvn clean test，Gradle运行gradle clean test，彻底清除旧编译文件后重新构建测试。
• IDE操作：IntelliJ执行"Invalidate Caches / Restart"，Eclipse执行"Clean Project"。

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