Kotlin协程测试超时：主协程阻塞无法恢复执行

核心问题定位 #

你的测试超时、主协程阻塞的根源大概率是无缓冲Channel的send挂起，结合UnconfinedTestDispatcher的调度特性，导致主协程卡在startChannel.send(true)步骤，无法执行后续的日志打印和await()逻辑。

具体来说：

• 默认创建的Channel<Boolean>是无缓冲的RendezvousChannel，调用send()时必须等待有接收方已调用receive()并处于挂起状态才能完成发送。
• 当你用UnconfinedTestDispatcher启动子协程时，协程会立即执行到startChannel.receive()并挂起，但主协程执行send(true)后，Unconfined调度器会优先让子协程在当前线程执行到下一个挂起点（比如发送消息到其他Channel），这会导致主协程暂时被抢占，若子协程的逻辑耗时较长（或在非测试调度器上执行），主协程无法及时恢复执行后续的send(true)和await()。

具体修复方案 #

1. 给startChannel添加缓冲 #

将startChannel改为带缓冲的，确保两次send()都能立即完成，不会阻塞主协程：

val startChannel = Channel<Boolean>(2) // 缓冲容量设为2，刚好容纳两个启动信号

这样主协程的两次send(true)不需要等待接收方，直接把数据写入缓冲，就能继续执行后续代码。

2. 移除UnconfinedTestDispatcher，使用runTest默认调度器 #

runTest默认会使用StandardTestDispatcher，它能更好地控制协程执行顺序，避免Unconfined带来的调度不确定性：

@Test
fun yourTest() = runTest { // 不需要手动指定UnconfinedTestDispatcher
    // 测试逻辑
}

如果你的子协程中用到了Dispatchers.IO等真实调度器，需要在测试中用Dispatchers.setMain(testDispatcher)替换，确保所有协程都在测试调度器上执行。

3. 确保子协程使用测试调度器 #

如果必须指定调度器，要确保子协程使用测试上下文：

val sender = async(testDispatcher) { // 显式传入runTest的testDispatcher
    startChannel.receive()
    // sender逻辑
}
val receiver = async(testDispatcher) {
    startChannel.receive()
    // receiver逻辑
}

4. 验证Channel的关闭（可选） #

如果测试完成后需要清理资源，可以在协程结束后关闭Channel，避免潜在的资源泄漏：

finally {
    startChannel.close()
}

验证修复后的流程 #

调整后，主协程的执行流程会变成：

1. 创建带缓冲的startChannel
2. 启动sender和receiver协程（两者立即执行到receive()，但因为Channel有缓冲，后续主协程的send不会阻塞）
3. 主协程执行两次send(true)，直接写入缓冲
4. sender和receiver协程从Channel读取启动信号，开始执行逻辑
5. 主协程执行到await()，等待两个子协程完成并获取结果
6. 执行断言逻辑

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