Cucumber JUnit5 @Before注解失效及Maven无测试执行问题排查

一、Maven命令行无测试执行问题解决 #

核心是确保Maven Surefire插件正确支持JUnit5，并配置Cucumber测试引擎。

1. 修正依赖配置 #

确保pom.xml中引入Cucumber与JUnit5集成的必要依赖，版本保持一致（推荐用最新稳定版）：

<dependencies>
    <!-- Cucumber核心 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.15.0</version>
        <scope>test</scope>
    </dependency>
    <!-- Cucumber JUnit5 集成引擎 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit-platform-engine</artifactId>
        <version>7.15.0</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit5 基础依赖 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit Platform Suite（用于测试启动类） -->
    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-suite-api</artifactId>
        <version>1.9.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 配置Maven Surefire插件 #

必须使用3.0.0及以上版本的Surefire插件，该版本原生支持JUnit5。同时指定测试启动类的匹配规则：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.1.2</version>
            <configuration>
                <includes>
                    <include>**/*Test.java</include> <!-- 匹配你的测试启动类命名 -->
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 修正测试启动类写法 #

替换JUnit4的@RunWith和@CucumberOptions，改用JUnit5的Suite注解体系：

import org.junit.platform.suite.api.ConfigurationParameter;
import org.junit.platform.suite.api.IncludeEngines;
import org.junit.platform.suite.api.SelectPackages;
import org.junit.platform.suite.api.Suite;

import static io.cucumber.junit.platform.engine.Constants.FEATURES_PROPERTY_NAME;
import static io.cucumber.junit.platform.engine.Constants.PLUGIN_PROPERTY_NAME;

@Suite
@IncludeEngines("cucumber") // 指定使用Cucumber测试引擎
@SelectPackages("com.your.test.package") // Step定义、Hook所在的包
@ConfigurationParameter(key = FEATURES_PROPERTY_NAME, value = "src/test/resources/features") // 特征文件路径
@ConfigurationParameter(key = PLUGIN_PROPERTY_NAME, value = "pretty, html:target/cucumber-report.html")
public class JU5Test {
    // 无需额外代码，配置通过注解完成
}

二、JU5Test类中@Before方法未触发问题解决 #

问题原因 #

JUnit5的org.junit.jupiter.api.Before是JUnit自身的测试生命周期注解，不会被Cucumber的测试生命周期触发。Cucumber有独立的钩子体系，需区分两种生命周期：

解决方案 #

1. 用Cucumber钩子替代JUnit注解

如果需要在每个Cucumber场景前执行代码，在Hook类中使用Cucumber的@Before注解：

import io.cucumber.java.Before;

public class SetupEnvHook {
    @Before // Cucumber的Before，每个场景执行前触发
    public void beforeEachScenario() {
        // 场景前置逻辑
    }

    @BeforeAll // Cucumber的BeforeAll，所有场景执行前仅触发一次
    public static void beforeAllScenarios() {
        // 全局前置逻辑
    }
}

2. 若需测试套件级别的前置逻辑

如果要在整个测试套件启动时执行代码，可在测试启动类中使用JUnit5的@BeforeAll，注意必须是静态方法：

@Suite
@IncludeEngines("cucumber")
// 其他配置注解...
public class JU5Test {

    @org.junit.jupiter.api.BeforeAll
    public static void beforeSuite() {
        // 测试套件启动前执行的逻辑，仅触发一次
    }
}

验证步骤 #

1. 执行mvn clean test，查看控制台输出确认测试被执行
2. 检查target/cucumber-report.html是否生成，验证测试结果

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