如何在Gradle中控制JUnit5与Cucumber测试的执行顺序？

核心问题分析 #

你遇到的问题本质是Cucumber测试引擎与JUnit Jupiter测试引擎在JUnit Platform中的执行逻辑相互独立，导致你尝试的JUnit Jupiter类排序配置无法覆盖Cucumber测试的执行顺序。此外，数据库状态未彻底隔离是引发构建失败的根本原因，控制执行顺序是临时 workaround，同时建议从测试隔离层面彻底解决问题。

方案1：拆分Gradle测试任务（最可靠的顺序控制） #

通过将SpringBootTest和Cucumber测试拆分为两个独立的Gradle任务，利用任务依赖关系强制指定执行顺序，完全规避测试引擎之间的顺序冲突。

Gradle配置示例 #

// 禁用原有test任务（或保留并排除其中一类测试，避免重复执行）
test {
    enabled = false
}

// Spring Boot专属测试任务
task testSpringBoot(type: Test) {
    useJUnitPlatform()
    // 匹配你的SpringBoot测试类，根据实际包名/类名调整通配符
    include '**/*ApplicationTests.class'
    include '**/*ServiceTests.class'
    
    // 继承原有test任务的配置（如Jacoco、系统属性）
    jacoco {
        enabled = true
    }
    systemProperties System.getProperties()
    testLogging {
        events 'PASSED', 'FAILED', 'SKIPPED'
    }
}

// Cucumber专属测试任务
task testCucumber(type: Test) {
    useJUnitPlatform()
    // 匹配Cucumber相关类（测试类、步骤定义类）
    include '**/*CucumberTests.class'
    include '**/*StepDefinitions.class'
    
    jacoco {
        enabled = true
    }
    systemProperties System.getProperties()
    testLogging {
        events 'PASSED', 'FAILED', 'SKIPPED'
    }
    
    // 强制依赖SpringBoot测试任务，确保先执行testSpringBoot
    dependsOn testSpringBoot
}

// 让Jacoco报告收集两个任务的覆盖率数据
jacocoTestReport {
    dependsOn testSpringBoot, testCucumber
    executionData fileTree(project.rootDir).include("**/build/jacoco/*.exec")
}

执行构建时，直接运行./gradlew testCucumber jacocoTestReport，Gradle会先完成testSpringBoot再执行testCucumber。

方案2：从测试隔离层面彻底解决问题 #

控制执行顺序只是临时方案，建议同时修复数据库状态隔离问题，彻底消除顺序依赖：

SpringBootTest侧 #

在测试类上添加@DirtiesContext注解，确保每个测试类执行后重置Spring上下文及关联的数据库：

@SpringBootTest
@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS)
public class UserServiceTests {
    // 测试代码
}

Cucumber侧 #

在步骤定义类中添加@Before钩子，每次场景执行前重置数据库状态：

public class UserStepDefinitions {
    @Autowired
    private JdbcTemplate jdbcTemplate;
    
    @Before
    public void resetDatabase() {
        // 清空所有业务表（根据实际表名调整）
        jdbcTemplate.execute("TRUNCATE TABLE users RESTART IDENTITY CASCADE");
        jdbcTemplate.execute("TRUNCATE TABLE orders RESTART IDENTITY CASCADE");
    }
    
    // 步骤定义方法
}

为什么之前的配置无效？ #

• JUnit Jupiter的ClassOrderer配置仅对JUnit Jupiter测试引擎生效，Cucumber使用独立的CucumberTestEngine，不遵守该规则。
• JUnit 5的@Suite机制无法同时协调两个不同测试引擎的执行顺序，Cucumber测试的发现逻辑不受Suite配置约束。

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