Python / 系统课时

取消任务时到底发生什么

取消任务时到底发生什么

在异步服务里,取消通常发生在超时、客户端断开或服务关闭时。真正要掌握的不是调用 cancel(),而是取消请求何时变成 CancelledError、它怎样沿 await 传播,以及为什么清理逻辑必须放进 finally。

学习目标

  • 说明 Task.cancel()、下一个挂起点与 CancelledError 之间的关系。
  • 追踪取消从子协程传播到等待方的完整路径。
  • 用 finally 正确释放连接、锁和其他异步资源。

cancel() 只是发出取消请求

task.cancel() 不会像“杀线程”一样立即终止代码。它先向任务登记取消请求;任务再次获得事件循环执行机会,并运行到可中断的挂起点时,CancelledError 才会在任务内部被抛出。因此,调用 cancel() 后仍应 await task,让任务完成清理并观察最终状态。

取消请求与异常传播时序

下面的程序把这条路径完整跑一遍。主协程先让工作任务进入 sleep,随后发出取消请求;工作任务不捕获取消异常,只在 finally 中做清理。

python
import asyncio


async def worker() -> None:
    print("worker: started")
    try:
        await asyncio.sleep(10)
    finally:
        # 无论正常返回、异常还是取消,都执行资源清理。
        print("worker: cleanup")


async def main() -> None:
    task = asyncio.create_task(worker())
    await asyncio.sleep(0.05)

    print("main: cancel requested")
    task.cancel()

    try:
        # 必须等待任务结束,才能确认清理完成并接收到取消结果。
        await task
    except asyncio.CancelledError:
        print("main: cancellation observed")

    print(f"task.cancelled() = {task.cancelled()}")


asyncio.run(main())

预期输出

text
worker: started
main: cancel requested
worker: cleanup
main: cancellation observed
task.cancelled() = True

CancelledError 会沿 await 传播

当一个协程正在 await 另一个可等待对象时,取消会从当前任务进入这个等待链。若被等待的操作没有把取消转换成别的结果,CancelledError 会继续向外传播,直到某一层明确处理它,或让最外层任务以“已取消”状态结束。

这里最重要的边界是:取消表示控制流决定,而不是普通业务失败。在现代 Python 中,asyncio.CancelledError 继承自 BaseException,因此通常的 except Exception 不会吞掉它。即便显式捕获,也应在完成必要处理后重新抛出,除非当前代码确实要把“取消”转换为另一种明确协议。

finally 才是可靠的清理边界

finally 的职责是把任务从“正在占用资源”恢复到“可安全结束”。网络代码里常见的清理对象包括连接、文件描述符、锁、临时状态和后台子任务。清理逻辑应尽量短,并避免重新进入长时间阻塞;否则取消已经发生,任务却会长时间停留在清理阶段。

如果资源本身支持异步上下文管理器,优先使用 async with,因为它会把获取与释放绑定在同一个结构里。手动管理资源时,则把释放动作放到 finally,而不是只放在正常返回路径。

判断取消是否真正完成

调用 cancel() 返回 True 只表示取消请求成功提交,并不表示任务已经结束。可靠的调用方通常执行“请求取消 → await 任务 → 处理 CancelledError”这三步。只有当取消异常最终从任务中传播出去时,task.cancelled() 才会返回 True。

这一区分在服务关闭时尤其重要:先向任务发送取消,再等待其清理完成,才能避免连接未关闭、锁未释放或进程退出时仍有挂起任务。把取消看成一条需要协作完成的控制流,而不是一次强制终止,就能正确设计异步任务的生命周期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

取消任务时到底发生什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通