JUnit Cucumber执行mvn test提示步骤未定义但实际已定义求助

你遇到的这个情况在Cucumber实践里挺常见的——明明步骤代码都写好了，和提示的片段完全匹配，却还是触发未定义的报错。结合你给出的配置信息，我整理了几个具体的排查和解决方向：

1. 修正glue配置的核心问题 #

你的@CucumberOptions里glue填的是src/test/java，这是文件系统的源码目录路径，但Cucumber要求这里必须填步骤定义类所在的包名，而非目录路径。比如你的步骤类都放在com.yourcompany.test.steps包下，应该改成：

@CucumberOptions(
    // 其他配置保持不变
    glue = { "com.yourcompany.test.steps" } // 替换为你实际的步骤类包路径
)

如果有多个包分散了步骤定义，就把所有相关包都列进去，比如glue = { "com.yourcompany.test.steps", "com.yourcompany.test.common" }。

2. 检查依赖版本兼容性 #

你使用的Cucumber核心版本是1.2.5，但搭配的cucumber-runner是1.3.3，这两个版本存在跨版本的兼容性风险。建议把cucumber-runner的版本调整为和Cucumber核心一致的1.2.5，避免版本不匹配导致的扫描逻辑异常。另外，注意Spring Boot的版本——Cucumber 1.2.5属于较旧的版本，建议搭配Spring Boot 1.x系列使用，若用2.x版本可能会出现依赖冲突。

3. 验证步骤定义的细节准确性 #

虽然你说步骤和提示片段完全匹配，但还是要仔细核对：

• 步骤定义的正则表达式和feature文件里的语句是否完全一致？比如有没有多余的空格、大小写差异，或者不小心混入的中文全角符号？
• 如果你用的是cucumber-java8的Lambda风格步骤，确保步骤类是public访问权限，没有拼写错误的注解或方法名。
• 结合Spring使用时，步骤类是否添加了@Component或@StepScope注解？缺失的话Cucumber可能无法通过Spring上下文扫描到这些类。

4. 排除扩展运行器的干扰 #

你当前用的是@RunWith(ExtendedCucumber.class)，这个扩展插件可能会干扰Cucumber的默认扫描逻辑。可以临时换成普通的Cucumber运行器测试：

@RunWith(Cucumber.class)
// 保留原有的@CucumberOptions和@ExtendedCucumberOptions（如果需要）
public class CucumberTest {}

如果换成普通运行器后问题解决，那就是扩展运行器的配置存在问题，需要调整@ExtendedCucumberOptions的参数。

5. 清理并重新编译项目 #

有时候旧的编译文件会导致类加载异常，执行以下命令重新构建项目，确保最新的步骤定义类被正确加载：

mvn clean compile test

6. 调整Surefire插件配置 #

你的Surefire插件版本是2.20，搭配的是surefire-junit47，可以尝试添加测试类的包含规则，明确指定要运行的Cucumber测试类，避免插件遗漏扫描：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>2.20</version>
  <configuration>
    <includes>
      <include>**/CucumberTest.java</include>
    </includes>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>org.apache.maven.surefire</groupId>
      <artifactId>surefire-junit47</artifactId>
      <version>2.20</version>
    </dependency>
  </dependencies>
</plugin>

内容的提问来源于stack exchange，提问作者F. MAUPIN