如何通过Gradle任务执行JUnit 5测试套件？

你遇到的核心问题是Gradle的测试标签筛选逻辑和JUnit Suite的执行逻辑不兼容：

• Gradle的includeTags("parallel")在测试发现阶段工作：它会扫描所有测试类/方法，只保留带有指定标签的节点。
• JUnit Suite的@SelectClasses在JUnit执行阶段生效：当Gradle已经把无标签的OneTest类排除后，JUnit套件根本没有机会执行这个类的测试方法。
• IDEA运行套件时直接触发JUnit的套件执行逻辑，跳过了Gradle的标签筛选步骤，所以能正常执行OneTest的方法。

方案1：给测试类添加对应标签（最直接） #

给OneTest类加上@Tag("parallel")，让Gradle的标签筛选能识别到它：

@Tag("parallel")
public class OneTest {
    @Test
    void firstMethod() {
        // 测试逻辑
    }
}

这样Gradle会把OneTest纳入执行范围，JUnit套件也会正常执行它的方法。

方案2：修改Gradle任务，直接指定测试套件类 #

如果不想给测试类加标签，让Gradle任务直接执行测试套件类，由JUnit处理套件的包含关系：

tasks.register('parallelTests', Test) {
    useJUnitPlatform {
        // 直接指定测试套件的全限定类名
        includeClasses('com.yourpackage.OneSuite')
        // 可选：保留标签筛选，确保只有带parallel标签的套件被执行
        includeTags('parallel')
    }
    // 可选：配置并行执行参数
    maxParallelForks = Runtime.runtime.availableProcessors()
}

这种配置下，Gradle会直接运行OneSuite，JUnit会自动执行套件包含的OneTest类，不受Gradle标签筛选的影响。

方案3：在JUnit套件内通过标签控制测试 #

如果需要在套件层面控制测试范围，同时配合Gradle的标签筛选，可以在套件上添加@IncludeTags：

@Suite
@SelectClasses(OneTest.class)
@Tag("parallel")
@IncludeTags("parallel") // 仅执行套件内带parallel标签的测试
public class OneSuite {
    @Test
    @Tag("parallel")
    void method() {
        // 测试逻辑
    }
}

然后给OneTest的firstMethod加上@Tag("parallel")，Gradle任务保持原有配置即可：

tasks.register('parallelTests', Test) {
    useJUnitPlatform {
        includeTags('parallel')
    }
}

运行Gradle任务时添加--info参数，查看日志中是否有类似Excluding test class com.yourpackage.OneTest的记录，确认是标签筛选导致该类被排除，验证解决方案是否生效。

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