Kotlin 协程高级用法之 NonCancellable

核心前提:
NonCancellable = 临时屏蔽取消信号 ,让代码块原子执行不中断 ,可用于任意代码位置 ,没有强制必须写在 finally 里。


用法1:官方推荐用法 → finally 块中(资源清理/收尾)

适用场景

协程无论成功/失败/取消 ,都必须执行的资源释放操作 (关流、关连接、释放锁);

因为 finally 里的挂起函数 会被取消中断,所以必须用 NonCancellable 包裹。

Android 实战代码

kotlin 复制代码
import kotlinx.coroutines.*
import androidx.lifecycle.lifecycleScope

// Android 页面中(Activity/Fragment)
lifecycleScope.launch(Dispatchers.IO) {
    var networkStream: NetworkStream? = null
    try {
        // ========== 可取消区域 ==========
        // 耗时网络/文件操作,cancel() 会立即中断
        networkStream = openNetworkStream()
        readStreamData(networkStream)
        delay(1000) // 挂起点,可被取消
    } finally {
        // ========== 必执行区域:协程任何结束方式都会进入 ==========
        // 官方规范:finally 中执行挂起收尾,必须用 NonCancellable
        withContext(NonCancellable) {
            // 纯资源清理,无业务成功逻辑
            networkStream?.close() // 挂起函数,不被取消中断
            releaseWorkerLock()
            log("资源已安全释放")
        }
    }
}

用法2:项目实战用法 → 业务成功分支中(原子提交)

适用场景

业务已确认成功 (如拿到服务端 resourceId),后续的内存赋值/DB 持久化 必须完整执行,不能被取消中断;
仅成功路径执行,失败/取消不进入。

Android 实战代码

kotlin 复制代码
import kotlinx.coroutines.*
import androidx.lifecycle.lifecycleScope

// Android 页面中(Activity/Fragment)
lifecycleScope.launch(Dispatchers.IO) {
    // ========== 可取消区域 ==========
    // 耗时上传操作,cancel() 会立即断开 OkHttp
    val resourceId = uploadFileToServer()

    // ========== 仅业务成功进入:原子提交区 ==========
    if (resourceId != INVALID_ID) {
        // 屏蔽取消,保证落盘逻辑完整执行
        withContext(NonCancellable) {
            // 1. 内存状态赋值
            currentItem.remoteId = resourceId
            currentItem.status = UploadStatus.SUCCESS
            // 2. 本地持久化(DB/SP)
            saveUploadResultToDb(currentItem)
            // 3. 通知 UI 更新
            withContext(Dispatchers.Main) {
                updateUploadUi(currentItem)
            }
        }
    }
}

用法3:最佳实践 → 两种用法共存(Android 标准工程代码)

成功分支做原子提交,finally 做资源清理,互不冲突、各司其职。

kotlin 复制代码
lifecycleScope.launch(Dispatchers.IO) {
    var uploadConnection: UploadConnection? = null
    try {
        // 1. 可取消:建立连接 + 上传文件
        uploadConnection = createUploadConnection()
        val resourceId = uploadConnection.executeUpload()

        // 2. 用法2:业务成功 → 原子提交(你的项目核心逻辑)
        if (resourceId != INVALID_ID) {
            withContext(NonCancellable) {
                currentItem.remoteId = resourceId
                saveUploadResultToDb(currentItem)
            }
        }
    } finally {
        // 3. 用法1:官方规范 → 无论如何都释放资源
        withContext(NonCancellable) {
            uploadConnection?.close() // 安全关闭连接
        }
    }
}

配套:外部取消的标准写法(Android 环境)

kotlin 复制代码
// 取消上传任务(删除逻辑)
private fun cancelUploadJob(job: Job) {
    lifecycleScope.launch {
        job.cancel() // 立即中断上传(断开 OkHttp)
        job.join()   // 等待:原子提交块 + finally 清理 全部执行完毕
        // 执行后续删除逻辑
        deleteRemoteResource(currentItem.remoteId)
    }
}

总结

  1. 无唯一写法 :NonCancellable 不是必须写在 finally 中,官方从未规定唯一用法
  2. 两种标准场景
    • finally + NonCancellable:官方规范 ,用于协程全生命周期的资源清理
    • 成功分支 + NonCancellable:工程实战 ,用于业务结果的原子提交 (你的项目用法)
      取消后必须用 join() 等待不可取消代码执行完毕
相关推荐
ComPDFKit2 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
FRing032 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
FungLeo3 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks3 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
琳少_4 小时前
java程序开发笔记
java·开发语言·数据库·笔记
七夜zippoe5 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
严肃小白兔6 小时前
PHP 8.6 正式发布:部分函数应用、原生 I/O 轮询与新特性实战解析
开发语言·php
郝学胜-神的一滴6 小时前
Effective Python 条款36:优雅拼装迭代器与生成器
开发语言·数据结构·人工智能·python·numpy·scikit-learn
wuyk5558 小时前
Python办公自动化-第04讲-批量新建Excel
开发语言·python·excel
code2cat9 小时前
【随笔】Java客户端选了HTTP/3,怎样知道请求实际走了哪个版本
java·开发语言·http