如何测试launch(dispatcher)中代码块是否在指定CoroutineDispatcher执行？

我之前在Android项目里也碰到过完全一样的坑！咱们来拆解问题，一步步解决它：

问题根源 #

你写的example函数里，直接调用了launch(dispatcher)——这个launch是无作用域的顶层扩展函数，它会尝试从当前的协程上下文里获取父上下文（parentContext）。但在测试环境中，没有默认的协程作用域或上下文兜底，所以parentContext会是null，最终触发空指针异常。

解决方案1：改用带作用域的Launch（推荐） #

首先要修正example函数的写法，明确给launch指定一个协程作用域，避免依赖隐式的上下文：

// 方案A：让函数接收一个CoroutineScope（更灵活，适合依赖注入场景）
fun example(scope: CoroutineScope, dispatcher: CoroutineDispatcher, block: () -> Unit) {
    scope.launch(dispatcher) { block() }
}

// 方案B：在函数内部创建一个作用域（简单直接，适合独立调用场景）
fun example(dispatcher: CoroutineDispatcher, block: () -> Unit) {
    CoroutineScope(dispatcher).launch { block() }
}

这样修改后，launch会使用我们指定的作用域上下文作为父上下文，再也不会出现空指针了。

解决方案2：用官方测试库验证Dispatcher #

接下来用kotlinx-coroutines-test库来写测试，它提供了专门的测试Dispatcher和作用域，能轻松验证代码是否在指定Dispatcher上执行：

测试代码示例（使用新版测试API）

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.test.StandardTestDispatcher
import kotlinx.coroutines.test.runTest
import org.junit.Test
import org.junit.Assert.assertEquals

class ExampleCoroutineTest {

    @Test
    fun `verify block runs on specified dispatcher`() = runTest {
        // 创建测试用的Dispatcher
        val testDispatcher = StandardTestDispatcher(testScheduler)
        var executedDispatcher: CoroutineDispatcher? = null

        // 调用我们的example函数
        example(testDispatcher) {
            // 记录当前执行的Dispatcher
            executedDispatcher = Dispatchers.current
        }

        // 推进协程执行到完成状态
        testScheduler.advanceUntilIdle()

        // 验证block确实在指定Dispatcher上执行
        assertEquals(testDispatcher, executedDispatcher)
    }
}

如果你用旧版测试API（TestCoroutineDispatcher）

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.test.TestCoroutineDispatcher
import kotlinx.coroutines.test.TestCoroutineScope
import kotlinx.coroutines.test.runBlockingTest
import org.junit.Test
import org.junit.Assert.assertEquals

class ExampleCoroutineTest {
    private val testDispatcher = TestCoroutineDispatcher()
    private val testScope = TestCoroutineScope(testDispatcher)

    @Test
    fun `block runs on specified dispatcher`() = testScope.runBlockingTest {
        var executedDispatcher: CoroutineDispatcher? = null

        example(testDispatcher) {
            executedDispatcher = Dispatchers.current
        }

        testDispatcher.advanceUntilIdle()
        assertEquals(testDispatcher, executedDispatcher)
    }
}

为什么不要自己Mock Dispatcher？ #

手动Mock CoroutineDispatcher会忽略协程上下文的内部关联逻辑，很容易出现parentContext空指针这类隐性问题。官方测试库的Dispatcher已经帮我们处理了所有上下文依赖，是最可靠的测试方案。

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