如何用命令运行所有Cucumber测试？解决mvn test无测试发现问题

核心排查与修复方案 #

1. 确认Runner类注解配置 #

RunnerTest.java必须通过正确注解让Maven识别为测试入口，示例代码如下：

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

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features", // 对应你的feature文件实际路径
    glue = "com.yourpackage.stepdefs", // 步骤定义类所在包
    plugin = {"pretty", "html:target/cucumber-reports"}
)
public class RunnerTest {
    // 无需业务代码，仅作为测试入口
}

• 若使用JUnit 5，需替换@RunWith(Cucumber.class)为@Cucumber注解，同时pom.xml要对应引入cucumber-junit-platform-engine依赖。

2. 修正pom.xml依赖与插件配置 #

确保Cucumber、JUnit依赖和Maven测试插件配置正确，标准配置示例：

<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基础依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <!-- Maven测试执行插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.1.2</version>
            <configuration>
                <!-- 指定扫描Runner类路径 -->
                <includes>
                    <include>**/*RunnerTest.java</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

• 关键注意点：
  • 所有Cucumber相关依赖版本保持一致，避免版本冲突
  • maven-surefire-plugin的<includes>必须覆盖你的Runner类路径，Maven默认仅识别命名为*Test.java的测试类
  • 测试类和依赖的<scope>必须设为test，确保Maven在测试阶段加载

3. 验证项目结构合规性 #

确保项目遵循Maven标准目录结构：

• src/main/java：存放业务代码
• src/test/java：存放测试代码（含RunnerTest.java、步骤定义类）
• src/test/resources：存放.feature测试用例文件

若.feature文件存放在子目录，需调整@CucumberOptions的features参数，比如路径为src/test/resources/com/yourpackage/features，则写成features = "classpath:com/yourpackage/features"

4. 命令行运行Cucumber测试的正确方式 #

• 运行所有测试：直接执行 mvn test，配置正确时会自动扫描并运行所有符合规则的测试类
• 指定单个Runner类运行：mvn test -Dtest=RunnerTest
• 查看测试报告：执行mvn test后，报告默认生成在target/cucumber-reports目录，打开index.html即可查看详情

常见错误排查 #

• 若提示“no tests found”，先确认RunnerTest.java是否在src/test/java目录下，Maven不会扫描src/main/java下的测试类
• 检查注解匹配：JUnit 5环境不要使用JUnit 4的@RunWith注解，需切换对应依赖和注解
• 清理缓存：执行mvn clean test，避免旧编译文件干扰测试执行

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