Cucumber Feature与Step定义无法关联，Maven子模块配置求解

我来帮你搞定这个头疼的问题——在Maven子模块里跑Cucumber测试找不到Step定义，还输出存根代码，大概率是路径配置或者文件结构的问题，咱们一步步来排查：

1. 先确认标准Maven子模块目录结构 #

首先得保证你的目录结构是Maven认可的，尤其是子模块的资源和测试代码位置，比如：

super-flights (父模块根目录)
├── pom.xml
└── super-flights-acceptancetests (子模块，注意你原来的拼写可能少了个e：acceptanctests → acceptancetests，这个拼写错误很容易导致路径匹配失败)
    ├── pom.xml
    └── src
        └── test
            ├── java
            │   └── com
            │       └── yourcompany
            │           └── flights
            │               ├── runners
            │               │   └── AcceptanceTestRunner.java (你的JUnit运行器类)
            │               └── steps
            │                   └── FlightBookingSteps.java (Step定义类)
            └── resources
                └── features
                    └── flight-booking.feature (你的Feature文件)

重点：Feature文件必须放在src/test/resources下，Maven才会把它加入测试类路径；Step定义类要放在src/test/java的对应包下。

2. 修正@CucumberOptions的核心配置 #

这是最容易出错的地方，给你一个标准的JUnit运行器配置示例，对应上面的目录结构：

package com.yourcompany.flights.runners;

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

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "classpath:features", // 用classpath方式最可靠，自动扫描测试类路径下的features目录
    glue = "com.yourcompany.flights.steps", // 必须精确指向Step定义所在的包名，Cucumber会扫描这个包及其子包
    plugin = {"pretty", "html:target/cucumber-reports.html"}, // 可选，生成报告用
    monochrome = true // 让控制台输出更整洁
)
public class AcceptanceTestRunner {
}

关键配置说明： #

• glue路径：绝对不能写错包名！比如你把com.yourcompany.flights.steps写成com.yourcompany.flight.steps（少了个s），或者大小写不一致，Cucumber就找不到Step类。另外，Step类必须是普通类（不能抽象），要有无参构造方法。
• features路径：如果不想用classpath，也可以用相对路径，但要注意是相对于子模块根目录，比如"src/test/resources/features"，但classpath方式更适配Maven的类加载机制，推荐优先用。

3. 正确执行Maven测试目标 #

别在父模块根目录直接跑mvn test，这样可能会忽略子模块的配置，正确的做法是：

• 进入子模块目录（super-flights-acceptancetests），执行：

  mvn test
  

• 或者在父模块根目录，指定子模块执行：

  mvn -pl super-flights-acceptancetests test
  

4. 检查Step定义的正确性 #

除了路径，还要确认Step类的注解和Feature步骤完全匹配：

• 比如Feature里写的是：

  Given I am on the flight booking page
  

  那Step定义的注解参数必须完全一致（包括空格、标点，默认大小写不敏感，但最好完全匹配）：

  @Given("I am on the flight booking page")
  public void iAmOnTheFlightBookingPage() {
      // 你的步骤逻辑
  }
  

• Step定义类必须加上Cucumber的注解（@Given/@When/@Then等），不能遗漏。

5. 确认Maven依赖兼容性 #

子模块的pom.xml里要包含正确的Cucumber和JUnit依赖，版本要统一，比如：

<dependencies>
    <!-- Cucumber核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.14.0</version> <!-- 用最新稳定版即可 -->
        <scope>test</scope>
    </dependency>
    <!-- Cucumber JUnit运行器 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit 4（因为用的是JUnit 4的运行器） -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

如果用JUnit 5的话，要换成cucumber-junit-platform-engine依赖，不过看你用的是JUnit运行器，应该是JUnit 4。

常见踩坑点 #

• 子模块名拼写错误：比如你原来的super-flights-acceptanctests少了个e，改成super-flights-acceptancetests试试，这个小错误很容易被忽略。
• Feature文件放错位置：不小心放到src/main/resources了，Maven测试时不会加载这个目录的资源。
• Step类没被编译：检查子模块的target/test-classes目录下有没有Step类的.class文件，如果没有，说明Maven没编译测试代码，可能是pom.xml的build配置有问题，比如没指定测试源码目录（不过Maven默认会识别src/test/java）。

按照上面的步骤排查，应该就能解决找不到Step定义的问题了！

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