如何在未找到或未执行测试时使Gradle构建失败？

为什么你的配置没生效 #

failOnNoMatchingTests参数仅在已指定测试筛选规则但未匹配到任何测试用例时生效。但如果注释掉useJUnitPlatform()，Gradle根本不会扫描测试类，相当于跳过了“筛选”环节，所以这个配置自然起不到作用。

具体解决方案 #

1. 启用JUnit平台（推荐）

如果项目使用JUnit 5，直接开启useJUnitPlatform()，同时保留failOnNoMatchingTests配置，Gradle会正常扫描测试类，一旦未找到可执行测试就触发构建失败：

test {
    useJUnitPlatform()
    filter.failOnNoMatchingTests(true)
}

2. 自定义检查任务（灵活适配场景）

如果必须在不启用JUnit平台的情况下检测，或者需要更严格的控制（比如必须存在测试类且执行），可以添加自定义任务：

task checkTestsRan {
    doLast {
        // 检查是否存在测试类
        def testSources = sourceSets.test.java.srcDirs
        def hasTestClasses = testSources.any { dir ->
            dir.exists() && dir.listFiles({ f -> f.name.endsWith('Test.java') } as FileFilter).length > 0
        }

        // 检查测试任务是否执行了测试
        def testTask = tasks.test
        def testsExecuted = testTask.testResult.testCount > 0

        if (hasTestClasses && !testsExecuted) {
            throw new GradleException("发现测试类但未执行任何测试，构建终止")
        } else if (!hasTestClasses) {
            throw new GradleException("未找到任何测试类，构建终止")
        }
    }
}

// 让构建检查阶段依赖这个任务
tasks.check.dependsOn(checkTestsRan)

该任务会先确认测试类存在，再检查是否有测试被执行，任一条件不满足就抛出异常终止构建。

3. 测试任务后置检查

直接在test任务执行后判断测试运行数量，为0则触发失败：

test {
    doLast {
        if (testResult.testCount == 0) {
            throw new GradleException("未执行任何测试，构建失败")
        }
    }
}

这种方式简单直接，不管是未扫描到测试类还是扫描到但未执行，只要最终无测试运行，就会终止构建。

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