用途
Kotlin Concurrency Expert 用于审查和修复 Android 代码库中的 Kotlin 协程问题。它通过应用结构化并发、生命周期安全、正确作用域和现代最佳实践,在尽量不改变现有行为的前提下完成修复。适用于以下请求:审查并发用法、修复协程相关缺陷、提升线程安全,或解决 ANR、内存泄漏、竞态条件、状态错误等问题。
主要能力
技能围绕一套工作流和规则展开,覆盖协程使用中的常见问题类型:
- 分诊问题:捕获确切的错误、崩溃或症状(ANR、内存泄漏、竞态条件、状态错误);检查项目的协程配置(kotlinx-coroutines-android 版本、lifecycle-runtime-ktx 版本);识别当前作用域上下文(viewModelScope、lifecycleScope、自定义作用域或无);确认代码是绑定 UI(Dispatchers.Main)还是应在主线程之外运行(Dispatchers.IO、Dispatchers.Default);验证调度器注入模式以便测试。
- 应用最小安全修复:优先选择在满足结构化并发和生命周期安全的同时保留现有行为的编辑。
常见修复包括:
- ANR / 主线程阻塞:将繁重工作移至 withContext(Dispatchers.IO) 或 Dispatchers.Default;确保挂起函数是主线程安全的。
- 内存泄漏 / 僵尸协程:用生命周期绑定的作用域(viewModelScope、lifecycleScope 或注入的 applicationScope)替换 GlobalScope。
- 生命周期收集问题:用 repeatOnLifecycle(Lifecycle.State.STARTED) 替换已弃用的 launchWhenStarted。
- 状态暴露:封装 MutableStateFlow / MutableSharedFlow;暴露只读的 StateFlow 或 Flow。
- 吞掉 CancellationException:确保通用的 catch (e: Exception) 块重新抛出 CancellationException。
- 非协作式取消:在紧凑循环中添加 ensureActive() 或 yield() 以实现协作式取消。
- 回调 API:将监听器转换为带正确 awaitClose 清理的 callbackFlow。
- 硬编码调度器:通过构造函数注入 CoroutineDispatcher 以便测试。
使用方式
技能以规则和代码示例的形式给出正确与错误写法对照,便于在审查和修复时直接参照。
关键规则包括:
- 调度器注入(可测试性):正确做法是通过构造函数注入调度器,例如 class UserRepository(private val ioDispatcher: CoroutineDispatcher = Dispatchers.IO),并在挂起函数中使用 withContext(ioDispatcher);错误做法是硬编码 Dispatchers.IO。
- 生命周期感知收集:正确做法是在 viewLifecycleOwner.lifecycleScope.launch 内使用 viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) 收集;错误做法是直接使用已弃用且不安全的 lifecycleScope.launchWhenStarted 收集。
- 状态封装:正确做法是在 ViewModel 中私有持有 MutableStateFlow,并通过 asStateFlow() 暴露只读 StateFlow;错误做法是直接暴露 MutableStateFlow,泄漏可变性。
- 异常处理:正确做法是先捕获 CancellationException 并重新抛出,再捕获 Exception 处理错误;错误做法是用 catch (e: Exception) 吞掉 CancellationException。
- 协作式取消:正确做法是在紧凑循环中调用 ensureActive() 检查取消;错误做法是循环中从不检查取消。
- 回调转换:正确做法是使用 callbackFlow,在 awaitClose 中移除监听器完成清理。
作用域选择指南:
- viewModelScope:用于 ViewModel 操作,随 ViewModel 清除。
- lifecycleScope:用于 Activity/Fragment 中的 UI 操作,随生命周期所有者销毁。
- repeatOnLifecycle:用于 UI 中的 Flow 收集,随生命周期状态启动/停止。
- applicationScope(注入):用于应用级后台工作,随应用生命周期。
- GlobalScope:永远不要使用,会破坏结构化并发。
测试模式示例:使用 runTest、StandardTestDispatcher(testScheduler)、FakeRepository 构造 ViewModel,调用 loadData() 后 advanceUntilIdle(),再断言 uiState.value 等于预期状态。
适用场景
适用于 Android 项目中需要审查或修复 Kotlin 协程用法的场景,尤其是出现 ANR、内存泄漏、竞态条件、状态错误、生命周期收集问题、取消异常被吞、回调 API 转换、调度器硬编码等具体症状时。也适用于希望按结构化并发和生命周期安全原则改进线程安全与可测试性的代码审查。
限制
资料未提供该技能的安装方式、运行环境要求、支持的具体版本范围、收费或价格信息、平台限制以及实际效果数据,这些内容暂未提供。技能本身聚焦于 Android 与 Kotlin 协程,未提及其他平台或语言的适用性。