使用Selenium+JUnit+Cucumber遇UndefinedStepException问题求助

• 核对步骤文本的完全匹配
  Cucumber对Feature文件步骤和Step实现类注解的文本匹配要求绝对严格，哪怕多一个空格、大小写差异、标点不同都会触发异常。比如Feature里写Given 我打开Chrome浏览器，而Step类注解是@Given("我打开chrome浏览器")（大小写不一致），就会匹配失败。逐字核对两者的文本内容，确保完全一致。

• 验证Glue路径的准确性
  再次确认Runner类中@CucumberOptions的glue参数是完整的包路径，比如你的Step类在com.automation.steps下，glue必须写glue = "com.automation.steps"，不能只写steps。同时确认Step类所在的包属于测试源码目录（比如src/test/java），没有被Maven或IDE排除在编译范围外。

• 检查依赖版本兼容性
  JUnit与Cucumber依赖版本不匹配是高频问题：

  • 若使用JUnit 4，需确保cucumber-junit和JUnit版本适配，示例依赖：

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

  • 若使用JUnit 5，需替换为cucumber-junit-platform-engine依赖，且所有Cucumber组件版本保持一致。

• 确认Step类及方法的访问权限
  Step实现类和其中的步骤方法必须用public修饰，private或默认访问权限会导致Cucumber无法扫描到这些方法，从而判定步骤未定义。

• 检查Feature文件的位置与编码
  Feature文件需放在src/test/resources目录下，或通过Runner类@CucumberOptions的features参数指定正确路径。同时确保文件编码为UTF-8，避免中文文本因编码问题出现匹配偏差。

• 清理项目并重新构建
  IDE缓存或编译产物异常可能引发问题，执行Maven命令清理并重新测试：

  mvn clean test
  

  或在IDE中执行「Clean Project」后重新编译运行。

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