Python / 系统课时
取消任务时到底发生什么
取消任务时到底发生什么
在异步服务里,取消通常发生在超时、客户端断开或服务关闭时。真正要掌握的不是调用 cancel(),而是取消请求何时变成 CancelledError、它怎样沿 await 传播,以及为什么清理逻辑必须放进 finally。
学习目标
- 说明
Task.cancel()、下一个挂起点与CancelledError之间的关系。 - 追踪取消从子协程传播到等待方的完整路径。
- 用
finally正确释放连接、锁和其他异步资源。
cancel() 只是发出取消请求
task.cancel() 不会像“杀线程”一样立即终止代码。它先向任务登记取消请求;任务再次获得事件循环执行机会,并运行到可中断的挂起点时,CancelledError 才会在任务内部被抛出。因此,调用 cancel() 后仍应 await task,让任务完成清理并观察最终状态。

下面的程序把这条路径完整跑一遍。主协程先让工作任务进入 sleep,随后发出取消请求;工作任务不捕获取消异常,只在 finally 中做清理。
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())预期输出
worker: started
main: cancel requested
worker: cleanup
main: cancellation observed
task.cancelled() = TrueCancelledError 会沿 await 传播
当一个协程正在 await 另一个可等待对象时,取消会从当前任务进入这个等待链。若被等待的操作没有把取消转换成别的结果,CancelledError 会继续向外传播,直到某一层明确处理它,或让最外层任务以“已取消”状态结束。
这里最重要的边界是:取消表示控制流决定,而不是普通业务失败。在现代 Python 中,asyncio.CancelledError 继承自 BaseException,因此通常的 except Exception 不会吞掉它。即便显式捕获,也应在完成必要处理后重新抛出,除非当前代码确实要把“取消”转换为另一种明确协议。
finally 才是可靠的清理边界
finally 的职责是把任务从“正在占用资源”恢复到“可安全结束”。网络代码里常见的清理对象包括连接、文件描述符、锁、临时状态和后台子任务。清理逻辑应尽量短,并避免重新进入长时间阻塞;否则取消已经发生,任务却会长时间停留在清理阶段。
如果资源本身支持异步上下文管理器,优先使用 async with,因为它会把获取与释放绑定在同一个结构里。手动管理资源时,则把释放动作放到 finally,而不是只放在正常返回路径。
判断取消是否真正完成
调用 cancel() 返回 True 只表示取消请求成功提交,并不表示任务已经结束。可靠的调用方通常执行“请求取消 → await 任务 → 处理 CancelledError”这三步。只有当取消异常最终从任务中传播出去时,task.cancelled() 才会返回 True。
这一区分在服务关闭时尤其重要:先向任务发送取消,再等待其清理完成,才能避免连接未关闭、锁未释放或进程退出时仍有挂起任务。把取消看成一条需要协作完成的控制流,而不是一次强制终止,就能正确设计异步任务的生命周期。