用途
本技能用于处理 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,奠基性文章)。
限制
以上为技能资料中明确提供的内容,未提供的功能、收费、平台等信息暂未提供。