0

0

Python 协程中取消任务的 CancelledError 处理

冷炫風刃

冷炫風刃

发布时间:2026-02-22 22:19:03

|

439人浏览过

|

来源于php中文网

原创

cancellederror是协程取消的控制流信号而非错误,需显式捕获并配合finally清理;它不继承exception,须单独处理;task.cancel()仅标记状态,await时才触发;asyncio.run()会静默吞掉未处理的cancellederror。

python 协程中取消任务的 cancellederror 处理

协程被取消时为什么直接抛 CancelledError 而不是静默失败

因为 CancelledError 是 Python 协程取消机制的信号载体,不是异常“错误”,而是控制流的一部分。它由 asyncio.Task.cancel() 触发,用于中断正在运行或等待中的协程。不捕获它,协程就终止;捕获它,你才有机会做清理。

常见错误现象:CancelledError 没被处理,导致日志里突然出现未捕获异常、资源没释放(比如文件句柄、数据库连接)、或者父任务误判子任务是“出错了”而不是“被取消了”。

  • 必须在 try/except 中显式捕获 CancelledError,不能只写 except Exception: —— 它不继承自 Exception,而是继承自 BaseException
  • 捕获后通常应立即重新抛出(raise),除非你确定要吞掉取消信号(极少见)
  • 清理逻辑(如 close()disconnect())必须放在 finally 块里,不能只靠 except

asyncio.wait_for 里 CancelledError 的来源和归属问题

asyncio.wait_for 在超时时会取消内部任务,此时抛出的 CancelledError 属于被等待的那个协程,不是 wait_for 自己抛的。很多人误以为 catch 住 asyncio.TimeoutError 就够了,结果漏掉了底层协程实际已被取消的事实。

使用场景:调用一个可能卡住的网络请求,设了 5 秒超时,但请求协程本身没做取消适配,导致 socket 连接一直挂着。

立即学习Python免费学习笔记(深入)”;

Sooolink企业信使1.0
Sooolink企业信使1.0

Sooolink企业信使是新一代的企业协同工作系统,以及时沟通为基础,将企业业务流程合理的穿插其中;给企业业务处理融入及时的消息,信息通知。让工作变得更加及时,有效,提高生产效率。目前暂时只发布了 windows 版本。

下载
  • asyncio.TimeoutErrorCancelledError 可能同时存在:前者是 wait_for 抛的,后者是它取消子任务时子任务自己抛的
  • 若子协程里没处理 CancelledError,整个调用栈会崩,TimeoutError 反而可能被掩盖
  • 推荐写法:在被 wait_for 包裹的协程内部,用 try/except CancelledError + finally 做清理,而不是只依赖外层超时处理

Task.cancel() 后 await task 为什么会再次触发 CancelledError

调用 task.cancel() 只是“标记”任务为取消状态,并不会立刻中断执行。真正抛 CancelledError 是在下一次 await(比如 await task 或协程内下个 await 表达式)时发生的。所以如果你 cancel 之后又 await task,就会看到异常——这不是重复抛,而是取消信号终于落地了。

性能影响:频繁 cancel + await 未完成的 task,会导致事件循环反复调度、异常对象创建,间接拖慢响应。

  • cancel 之后别盲目 await task,先用 task.done() 判断是否已结束
  • 如果只是想“确保取消”,用 await asyncio.shield(task) 不合适;正确做法是 if not task.done(): await task,并在 task 内部处理好 CancelledError
  • 注意 asyncio.create_task() 创建的任务默认不可取消(除非你传 name=... 并保留引用),cancel 失败也不会报错,容易误以为生效了

asyncio.run() 退出时 CancelledError 被吞掉的隐性行为

asyncio.run() 在主协程返回或异常退出后,会自动 cancel 所有还在 pending 的 task,并静默忽略它们的 CancelledError。这很方便,但也掩盖了本该被观察到的资源泄漏或未完成清理。

容易踩的坑:你在 main 里启动了一个后台心跳协程,main 结束后心跳 task 被 cancel,但它没做任何清理(比如关 socket),而你完全不知道——因为 CancelledErrorrun() 吞了,日志里什么都没有。

  • 开发阶段建议改用 asyncio.get_event_loop().run_until_complete(main()),这样未处理的 CancelledError 会暴露出来
  • 所有长期运行的 task 都应自带取消处理逻辑,不能依赖 asyncio.run() 的兜底
  • 可以用 asyncio.all_tasks() + loop.set_exception_handler() 主动监控未处理的取消异常

最常被忽略的一点:取消不是“停止”,而是“协作式中断”。协程自己得愿意停下来,并且知道怎么收摊——否则 CancelledError 就只是个没人认领的通知。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

826

2023.08.22

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

421

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

595

2023.08.10

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

374

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2094

2023.08.14

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

356

2023.08.31

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

259

2023.09.05

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

329

2023.10.09

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

1030

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号