该技能用于在多个协程之间设计取消、失败与生命周期关系。其一句话概括是:把协程嵌套在生命周期构成树形结构的显式作用域下,使取消、失败传播和资源清理变得可预测且自动完成。
适用场景:多个并发操作需要协调时,例如合并结果、传播取消或隔离失败;函数派生并等待所有子协程完成的场景;同辈失败不应取消其他同辈时使用 supervisorScope;同辈失败应取消其他同辈(快速失败)时使用 coroutineScope。不适用场景:单一挂起调用单一挂起函数,没有并发需要组织;真正独立且失败对程序其余部分无影响的即发即弃工作——不过即使如此,使用作用域通常仍值得。
主要能力:coroutineScope { … } 是快速失败分组,在其块中作为调用方作用域的子级运行,挂起直到所有子协程完成;任一子协程失败,其余子协程被取消,失败重新抛给调用方。supervisorScope { … } 提供隔离子协程,形状与 coroutineScope 相同,但子协程失败不会取消其同辈,适用于各子协程相互独立、一个失败不应终止其他子协程的情况。SupervisorJob 用于长生命周期作用域,构造长期存活的 CoroutineScope(如管理器类)时传入 SupervisorJob(),使单个子协程失败不会拆掉整个作用域,例如:val scope = CoroutineScope(SupervisorJob() + Dispatchers.Default)。取消会向下传播:取消父级会取消所有子级;子协程在挂起点检查取消(多数协程库函数可取消);没有挂起点的长时间 CPU 工作应周期性调用 ensureActive() 或 yield() 以保持可取消。清理使用 finally 与 NonCancellable:即使被取消也必须运行的清理工作放在 finally 块中;若清理本身会挂起,用 withContext(NonCancellable) { … } 包裹,避免取消立即再次取消清理。
使用方式与决策启发:快速失败(一个失败取消同辈并向上传播)→ coroutineScope;隔离(同辈独立,记录或跳过失败)→ supervisorScope 或自定义作用域上的 SupervisorJob;HTTP 请求处理需要原子完成或失败 → coroutineScope;后台扇出且每个任务独立(通知、刷新)→ supervisorScope;周期性 CPU 密集工作 → 调用 ensureActive() 使取消生效。
反模式:使用 GlobalScope 派生协程,破坏结构化并发,子协程不绑定任何有意义的生命周期;手动创建 Job 并到处传递却忘记取消,导致协程泄漏;捕获 CancellationException 并将其吞掉,破坏取消传播,若捕获则应重新抛出;在协程中运行不可中断的 CPU 工作而不调用 ensureActive(),取消请求会被忽略直到工作完成。
限制:不适用于无并发可组织的单一挂起调用;真正独立的即发即弃工作虽可不用,但通常仍建议作用域化。资料未提供该技能自身的安装命令、收费、平台或价格信息。相关主题包括 kp-coroutine-scope(构建块)、kp-launch-vs-async、kp-dispatchers、kp-anti-patterns。