本文介绍一种可靠的 gradle 插件方案，用于在构建时自动检测并报错未被执行的测试类，从而杜绝因依赖配置错误（如混用 junit 4/5、遗漏 testimplementation 声明）导致的测试静默忽略问题。
本文介绍一种可靠的 gradle 插件方案，用于在构建时自动检测并报错未被执行的测试类，从而杜绝因依赖配置错误（如混用 junit 4/5、遗漏 testimplementation 声明）导致的测试静默忽略问题。
在多版本测试框架共存（如 JUnit 4 与 JUnit 5 混用）的项目中，Gradle 构建极易因依赖声明不完整或测试引擎配置不当，导致部分 @Test 类被完全跳过执行——而控制台日志往往仅显示“0 tests found”或静默忽略，无明确警告。IntelliJ 可能正常运行全部测试，但 ./gradlew test 却遗漏若干类，这种不一致极易掩盖质量风险。
解决该问题的核心诉求并非提升测试覆盖率，而是保障“已存在”的所有测试类 100% 被执行。此时，静态分析（如扫描 src/test/java/**/*Test.java）结合运行时验证是最直接的手段。
推荐使用开源 Gradle 插件：gradle-testnotrunerror（GitHub 仓库：qux7/gradle-testnotrunerror）。该插件会在 test 任务执行后，比对源码中所有符合测试命名规范（如 *Test, *Tests, Test*）或含 @Test 注解的类与实际执行的测试类列表；若发现源码中存在但未被执行的类，则立即使构建失败，并清晰输出被忽略的类名及可能原因（如缺失依赖、测试引擎不匹配等）。
接入步骤如下（Gradle Kotlin DSL）：
plugins {
id("io.github.qux7.testnotrunerror") version "1.3.0" apply true
}
✅ 支持 Gradle 7.0+ 与 JUnit 4/5/Mockito 等主流测试库；
⚠️ 注意：插件默认扫描src/test/java下所有候选测试类，如项目使用非标准目录或自定义测试后缀，可通过testNotRunError { ... }闭包调整匹配规则；
? 运行./gradlew test后，若一切正常则无额外输出；若存在未执行测试，终端将抛出类似错误：FAILURE: Build failed with an exception. * What went wrong: Some test classes were not run: [com.example.MyLegacyTest, com.example.NewFeatureTests] Possible causes: missing testImplementation dependency, incorrect JUnit platform version, or misconfigured test task.
该方案将“测试是否被运行”从人工核对或经验判断，转变为可自动化、可重复验证的构建守门员（build gatekeeper），显著提升 CI/CD 环境下测试可靠性的底线保障能力。建议所有中大型 Java/Kotlin 项目在引入初期即集成，避免长期积累“幽灵测试”债务。
