1. ViewModelScope 生命周期绑定：作用域创建时机、与 ViewModel 的关联、自动取消原则

ViewModelScope 是 Android Architecture Components 为 ViewModel 提供的协程作用域扩展属性。它的核心设计目标是让 ViewModel 发起的协程与 ViewModel 自身绑定：当 ViewModel 被系统销毁（即 onCleared() 被调用）时，作用域内所有未完成的协程自动取消，开发者无需手动管理协程生命周期。本章从三个关键维度拆解这一绑定机制。

1.1 关键概念一览

概念 含义 关联代码 / 时机
作用域创建时机 ViewModel 对象被创建时，viewModelScope 属性按需初始化 第一次访问 viewModelScope 时触发 CloseableCoroutineScope 构造
与 ViewModel 的关联 通过 SupervisorJob 绑定到 ViewModel 的 onCleared() 回调 ViewModel 内部持有 Job，在 clear() 时调用 job.cancel()
自动取消原则 ViewModel 销毁时，作用域内所有协程无条件取消，不阻塞主线程 通过 CancellationException 传播取消信号

1.2 作用域创建时机：懒加载 & 单次初始化

viewModelScope 是一个只读扩展属性，源码实现为懒加载模式：

val ViewModel.viewModelScope: CoroutineScope
    get() {
        val scope: CoroutineScope? = this.getTag(JOB_KEY)
        if (scope != null) {
            return scope
        }
        return setTagIfAbsent(
            JOB_KEY,
            CloseableCoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)
        )
    }
  • 创建时机：首次读取 viewModelScope 时，通过 setTagIfAbsent 保证全局唯一。
  • 作用域配置：SupervisorJob（子协程失败不影响同级） + Dispatchers.Main.immediate（默认主线程调度）。
  • 避免重复创建：后续访问直接返回已缓存的 CloseableCoroutineScope 实例。

1.3 与 ViewModel 的关联：onCleared 触发取消

ViewModel 的 clear() 方法（由 ViewModelStore 在界面销毁时调用）会执行以下逻辑：

@MainThread
final void clear() {
    mCleared = true;
    // 如果有 closeable 对象（包括 CloseableCoroutineScope），自动关闭
    if (mBagOfTags != null) {
        for (Object value : mBagOfTags.values()) {
            closeWithRuntimeException(value);
        }
    }
    onCleared();
}

由于 CloseableCoroutineScope 实现了 Closeable 接口，在 clear() 时会被自动关闭，其内部 coroutineContext[Job] 被取消。关键点：

  • 取消是非阻塞的：仅发送 CancellationException，不会等待协程终止。
  • 传递性：作用域下所有协程（包括 launch / async 起始的）均被取消。

1.4 自动取消原则：协程生命周期对齐

自动取消保证了内存安全和状态一致性：

  1. 内存泄漏零容忍：如果 ViewModel 持有耗时协程（如网络请求、数据库查询），且 ViewModel 已不可见，协程仍可能回传数据到已销毁的 UI，导致 NullPointerException 或内存泄漏。自动取消从根源杜绝此问题。
  2. 取消是“最终一致性”：协程在下一个挂起点（如 delay()、withContext()、suspend 函数调用）检查取消状态并抛出 CancellationException。
  3. 不可阻塞：取消信号不强制协程立即终止，但所有标准挂起函数均支持协作式取消。
最佳实践：始终在 ViewModel 中使用 viewModelScope.launch 而非自定义 GlobalScope 或 lifecycleScope，以确保协程生命周期与 ViewModel 同步。对于需要独立于 ViewModel 的长期任务，考虑使用 WorkManager。

1.5 生命周期绑定流程图

下图展示了从 ViewModel 创建到作用域取消的完整链路：

ViewModelScope 生命周期绑定流程 1. ViewModel 初始化 2. 首次访问 viewModelScope 3. 创建 CloseableCoroutineScope 4. viewModelScope.launch 5. onCleared() 被调用 6. scope.cancel() 协程在最近挂起点自动响应取消

1.6 常见错误与稳定性优化

  • 错误：在 ViewModel 外部使用 viewModelScope
    viewModelScope 是 androidx.lifecycle.ViewModel 的扩展属性，普通类或非 ViewModel 组件无法引用。
  • 错误：混淆 lifecycleScope 与 viewModelScope
    lifecycleScope 绑定到 Activity/Fragment 生命周期，当界面配置变更时重新创建；viewModelScope 则跟随 ViewModel，配置变更后仍存活（除非 Activity 被销毁）。
  • 优化：及时取消不再需要的协程
    如果 ViewModel 内部分支逻辑提前得知不再需要某协程结果（例如用户离开页面后不再更新），可手动调用 job.cancel() 提前释放资源。
  • 优化：避免在 onCleared 中执行挂起操作
    onCleared() 在主线程同步执行，任何挂起调用都会导致死锁或异常；应在协程内使用 NonCancellable 上下文执行清理，但通常无需手动干预。

1.7 调试方法

使用以下手段验证 ViewModelScope 的自动取消：

  • 日志输出：在协程的 finally 块打印取消信息。
  • Android Profiler：观察协程线程状态，验证 ViewModel 销毁后线程数下降。
  • 单元测试：使用 TestCoroutineDispatcher + MockViewModel 手动触发 onCleared() 并断言协程状态为 cancelled。
// 调试示例：在协程内部检查取消状态
viewModelScope.launch {
    try {
        // 模拟耗时任务
        delay(5000)
        Log.d("Test", "任务完成")
    } catch (e: CancellationException) {
        Log.d("Test", "协程被取消: $e")
        throw e // 必须重新抛出，确保作用域感知
    }
}
← 上一章 📖 返回目录 下一章 →