Kotlin JUnit5协程测试偶现无法发现、被静默跳过问题咨询

这不是协程本身的问题，是三个机制叠加导致的异常现象：

1. kotlin.test提供的assertFailsWith方法存在返回值，会返回捕获到的异常实例，类型为声明的异常类（这里是ClientRequestException）
2. 你使用了Kotlin表达式函数体写法定义测试方法（fun test() = runBlocking { ... }），编译器会自动将函数返回值推断为lambda最后一行的返回类型，也就是ClientRequestException，而非JUnit要求的Unit/void类型
3. JUnit 5默认规则下，返回值非void的@Test方法会被直接静默忽略：Gradle执行全量测试时会直接跳过该方法不执行，IDEA单独指定运行该方法时会因为方法签名不符合测试要求，直接提示"No tests found for given includes"，全程不会有任何报错提示。

你提到的两种修改方案之所以生效，本质是因为变量赋值、assertEquals调用的返回值都是Unit，编译器最终会将测试方法的返回值推断为Unit，刚好符合JUnit的测试方法签名要求。

有两种零侵入的修复方式，选任意一种即可：

• 方案1：将表达式函数体改为普通块体写法，从根源上避免返回值自动推断：

// 修正后写法
@Test
fun testRequestFails() {
    runBlocking {
        assertFailsWith(ClientRequestException::class) {
            val result = httpClient.get<MyResponse>("$baseUrl/some/req/that/should/fail") {
                header(API_KEY_HEADER, testApiKey)
            }
        }
    }
}

• 方案2：保留表达式函数体，但显式声明测试方法返回值为Unit，强制编译器丢弃内部非Unit返回值：

// 修正后写法
@Test
fun testRequestFails(): Unit = runBlocking {
    assertFailsWith(ClientRequestException::class) {
        val result = httpClient.get<MyResponse>("$baseUrl/some/req/that/should/fail") {
            header(API_KEY_HEADER, testApiKey)
        }
    }
}

额外优化建议：协程相关测试可以替换手写runBlocking为kotlinx-coroutines-test提供的runTest，可以自动跳过延迟、统一管理测试调度器，减少测试执行不稳定问题，但该方案不解决返回值推断问题，仍需按上述两种方式保证方法返回Unit。

你当前使用的JUnit 5.7.0原生支持非void测试方法的严格检测，不需要额外依赖，两步配置即可：

1. 在src/test/resources目录下新建junit-platform.properties配置文件
2. 添加如下配置项，开启返回值严格校验：

junit.jupiter.testmethod.return.type.enforcement = enforce_void

开启后，只要存在返回值非void/Unit的@Test、生命周期方法，测试任务会直接抛出初始化错误、执行失败，不会再出现静默跳过的情况。

如果需要更严格的检测，还可以在Gradle的test任务中添加测试用例数量校验逻辑，比如要求每个测试目录下的测试类至少执行指定数量的用例，避免其他原因导致的测试漏跑。

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