如何在Gradle中屏蔽JUnit测试套件类执行避免测试重复运行

问题根因 #

Gradle默认的JUnit 4测试扫描逻辑，会同时识别两类测试单元：

• 包含实际@Test方法的普通测试类
• 被@RunWith(Suite.class)标记的聚合套件类
  而套件类本身的作用就是聚合普通测试类做批量执行，这就导致被套件引用的普通测试类会被扫描两次：一次是作为独立的普通测试类执行，一次是被套件类触发二次执行，最终出现测试总量虚高的问题。

落地配置方案 #

所有配置都在构建脚本层面完成，不需要修改任何现有测试类、套件类的代码逻辑，完全适配当前迁移阶段的零代码改动要求。
操作步骤：

• 定位到业务模块下的构建脚本：Groovy DSL为build.gradle，Kotlin DSL为build.gradle.kts
• 在test任务的配置块中添加套件类排除规则

Groovy DSL参考配置：

test {
    // 保持原有JUnit4执行引擎不变
    useJUnit()
    // 原生支持的排除规则：过滤所有使用Suite Runner的聚合类
    options {
        excludeCategories 'org.junit.runner.RunWith', 'org.junit.runners.Suite'
    }
    // 可选兜底优化：排除类名带Suite后缀的类，减少无效扫描开销
    exclude '**/*Suite.class'
}

Kotlin DSL参考配置：

tasks.test {
    useJUnit()
    options {
        excludeCategories("org.junit.runner.RunWith", "org.junit.runners.Suite")
    }
    exclude("**/*Suite.class")
}

执行效果 #

配置生效后，Gradle的测试扫描逻辑会回归到原自研ANT工具的行为：

• 仅扫描并执行所有包含实际@Test注解方法的普通测试类
• 不会将没有实际测试方法的聚合套件类作为独立执行单元触发二次运行
• 最终测试执行总量会回到原有4400用例的基准水平，不存在重复执行的问题

补充说明：该排除规则对所有JUnit版本下的Suite类均生效，不会误伤普通业务类。哪怕个别套件类的命名不带“Suite”后缀，基于Runner注解的排除规则也能完整覆盖所有真正的聚合类，兜底的类名规则仅用于优化扫描性能，不承担核心过滤逻辑。

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