SuperAPI AI 工具集

kp-dispatchers

编程与开发

查看项目

更新于 10-16 16:28

技能介绍

用途

该技能用于回答“协程应该跑在哪个调度器上”这一问题,帮助在编写或评审 Kotlin 协程代码时,根据工作的并发特征选择匹配的线程池。适用场景包括:设计具有特定并发特征的挂起函数(CPU 密集、阻塞 I/O、UI 绑定);处理将阻塞调用与协程混用、可能耗尽线程池的代码;在计算中途用 withContext 切换调度器;以及在代码评审中验证调度器的选择是否出于明确意图。

何时不应使用

当工作只是对另一个挂起函数的单次挂起调用时,通常无需选择调度器。当代码已经运行在感知调度器的框架原语中(例如 viewModelScope 默认使用 Main.immediate)时,也无需自行选择。

主要能力:各调度器的特征与适用条件

Dispatchers.Default:线程池大小按 CPU 核心数设置(通常为 max(2, 核心数))。适用于 CPU 密集型计算(解析、转换、数学运算)。把它跑满是可接受的,因为这些线程数正适合该机器。

Dispatchers.IO:线程池更大(默认 64 以上),针对阻塞式 I/O 优化。适用于调用 JDBC、文件 I/O、阻塞式 HTTP 客户端,或任何会调用 Thread.sleep / 发生阻塞的代码。这里的线程可以休眠而不至于饿死 CPU 工作。

Dispatchers.Main:单线程,在有 UI 线程的平台上(Android、JavaFX、Swing)绑定到 UI 线程。用于 UI 更新。调用是挂起的,不会在挂起之间阻塞 UI 线程。Main.immediate 在已处于 Main 时跳过派发。

Dispatchers.Unconfined:在首次挂起之前运行于调用该协程的线程,之后运行于恢复它的线程,行为不可预测。用于测试协程逻辑(线程无关紧要时),生产环境极少使用。Soshin 对其提出了警告。

使用方式

用 withContext 切换调度器。在挂起函数内部,withContext(Dispatchers.IO) { … } 会在 IO 调度器上运行该代码块,并在完成后切回。这是编写需要特定调度器的挂起函数体的惯用方式:

suspend fun loadUser(id: UserId): User = withContext(Dispatchers.IO) { database.query("SELECT * FROM users WHERE id = ?", id) // blocking JDBC }

调用方无需知道该函数使用哪个调度器——函数会为其工作选择合适的调度器。

自定义调度器:对于非常特定的需求(单线程队列、自定义大小的 work-stealing 池),可使用 Executors.newSingleThreadExecutor().asCoroutineDispatcher() 或类似方式。需记录为何需要自定义调度器;内置调度器已能满足大多数情况。

决策启发式

  • CPU 密集型(计算、解析、内存中数据转换)→ Default。
  • 阻塞式 I/O(JDBC、阻塞 HTTP、文件 I/O)→ IO。
  • UI 更新 → Main。
  • 除非有书面理由,生产环境不要使用 Unconfined。
  • 始终用 withContext(Dispatchers.IO) 包裹阻塞调用——否则会饿死当前所在的调度器。

反模式

  • 在 Default 上运行阻塞式 JDBC / 阻塞 HTTP——会饿死 CPU 调度器,扼杀吞吐量。
  • 在生产环境使用 Dispatchers.Unconfined——线程不可预测,bug 难以复现。
  • 在服务端为非 UI 工作使用 withContext(Dispatchers.Main)——无理由地固定到单线程。
  • 在 launch/async 内部手动切换调度器,而非使用 withContext——徒增间接层而无收益。

相关主题

kp-coroutine-scope(作用域的默认调度器)、kp-launch-vs-async(withContext 与 launch/async 的对比)、kp-anti-patterns(协程反模式)。

参考资料

Kotlin Design Patterns and Best Practices(Alexey Soshin),第 6 章(Threads and Coroutines);Kotlin 协程官方指南——协程上下文与调度器。