SuperAPI AI 工具集

kp-coroutine-scope

编程与开发

查看项目

更新于 10-16 16:28

技能介绍

用途

本技能用于处理 Kotlin 协程的生命周期与作用域归属问题。它的核心主张是:每个协程都属于一个 CoroutineScope,作用域拥有协程的生命周期——作用域被取消,其下协程即被取消。因此,选择正确的作用域是最常见的协程设计决策。

何时使用

  • 启动协程时不确定该挂载到哪个作用域。
  • 协程超出其有效工作范围仍在运行(屏幕关闭后、请求返回后、测试结束后仍在跑),这是作用域归属问题。
  • 代码中使用了 GlobalScope——这几乎总是错误的,本技能会说明替代方案。
  • 测试设置把协程泄漏到其他测试中。

何时不使用

  • 单个 suspend 函数被另一个 suspend 函数直接调用——无需 launch。
  • 工作是一次性转换,不需要超出本次调用存活——应使用 withContext 而不是 launch。

主要能力

作用域是生命周期锚点。 CoroutineScope 由 Job(或 SupervisorJob)和 CoroutineContext 创建。Job 被取消时,从该作用域启动的每个协程都会被取消,结构化并发依赖于此。

代码示例:

val scope = CoroutineScope(SupervisorJob() + Dispatchers.Default)
scope.launch { … }       // 运行直到作用域被取消或完成
scope.cancel()           // 取消从此作用域启动的每个协程

常见预置作用域:

  • viewModelScope(Android ViewModel)——ViewModel 被清除时取消,用于应随屏幕销毁的 UI 相关工作。
  • lifecycleScope(Android Lifecycle)——生命周期所有者被销毁时取消。
  • runBlocking { … }——创建一个阻塞调用线程直到所有协程完成的作域,适用于 main() 和测试,绝不要在生产的服务器代码中使用。
  • coroutineScope { … }——在当前作用域内运行代码块并传播取消,所有子协程完成后返回,是结构化并发的原语。
  • supervisorScope { … }——类似 coroutineScope,但子协程失败不会取消兄弟协程。

GlobalScope 几乎总是错误的。 它没有生命周期,在其中启动的协程会比一切都活得久。只有真正需要比所有组件都长寿的应用级后台工作才使用(实践中很少见)。多数想用 GlobalScope 的代码,更适合绑定到工作自然生命周期的作用域。

自定义作用域。 当没有合适的预置作用域时,创建一个绑定到拥有该工作的组件生命周期的作域:

class CartManager {
    private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Default)
    fun start() { scope.launch { … } }
    fun stop() { scope.cancel() }
}

拥有该作用域的组件负责取消它。

决策启发式

  • 让作用域的生命周期匹配工作的自然生命周期:应随屏幕销毁的工作 → viewModelScope / lifecycleScope;应随组件销毁的工作 → 组件自己拥有的作用域。
  • 如果想用 GlobalScope,停下来问“实际的生命周期是什么”,通常有更好的答案。
  • 对于返回前就完成的一次性工作,用 withContext { … } 而非 launch { … }。
  • 绝不要在协程内部或 Web 请求处理器中使用 runBlocking——会阻塞线程,违背初衷。

反模式

  • 对有更短自然生命周期的工作使用 GlobalScope.launch { … }——协程泄漏,工作不再需要后仍继续,结果被静默丢弃。
  • 创建 CoroutineScope 却从不取消它——实践中与 GlobalScope 相同。
  • 在生产服务器代码中使用 runBlocking——阻塞 HTTP 工作线程。
  • 手动构造 Job 并到处传递来混合作用域——导致“谁拥有这个 Job”的混乱。让作用域拥有自己的 Job。

相关技能

  • kp-launch-vs-async——有了作用域后该用哪个构建器。
  • kp-structured-concurrency——嵌套作用域中的 coroutineScope 与 supervisorScope。
  • kp-dispatchers——在作用域内选择正确的调度器。
  • kp-anti-patterns——协程相关反模式及识别方法。

参考资料

  • Kotlin Design Patterns and Best Practices(Alexey Soshin),第 6、8 章(Threads and Coroutines;Designing for Concurrency)。
  • Roman Elizarov 的 “Structured concurrency”(Medium,奠基性文章)。

限制

以上为技能资料中明确提供的内容,未提供的功能、收费、平台等信息暂未提供。