讲师中心 微信公众号
AI工具推荐 视频效率加速

Python 协程里怎么正确处理取消(asyncio.CancelledError)

胖静君_3543

胖静君_3543

发布时间:2026-01-25 12:06:02

|

221人浏览过

|

来源于php中文网

原创

协程被取消时一定会抛出 asyncio.CancelledError,它继承自 BaseException,需显式捕获;finally 块总执行,适合清理;子任务不会自动取消,需手动管理;测试需确保协程处于 await 状态。

python 协程里怎么正确处理取消(asyncio.cancellederror)

协程被取消时一定会抛出 asyncio.CancelledError

这不是可选行为,而是 asyncio 的核心机制:只要任务被 cancel(),且该任务正在等待(如 await asyncio.sleep(1)),事件循环就会在下一次调度时主动抛出 asyncio.CancelledError。它继承自 BaseException(不是 Exception),所以 except Exception: 捕获不到——这是最常踩的坑。

  • 必须显式写 except asyncio.CancelledError: 或 except BaseException:(不推荐后者,会吞掉其他严重异常)
  • 如果协程里有 try/finally,finally 块一定会执行,无论是否被取消——适合做资源清理
  • 在 except asyncio.CancelledError: 中再抛出该异常(raise),是允许协程“合作式退出”的标准做法

在 async with 和 async for 中取消可能被延迟

异步上下文管理器(__aenter__/__aexit__)和异步迭代器(__aiter__/__anext__)内部若存在阻塞或长耗时 await,取消信号可能要等当前 await 完成后才生效。比如:

async def slow_iter():
    for i in range(5):
        await asyncio.sleep(2)  # 取消请求在此处不会立即中断
        yield i
  • 不要依赖“立刻停止”,而要在关键步骤插入 if asyncio.current_task().cancelled(): raise asyncio.CancelledError()
  • 使用 asyncio.wait_for(coro, timeout) 包裹慢操作,比手动轮询更可靠
  • 自定义 AsyncContextManager 时,在 __aexit__ 中检查 exc_type is asyncio.CancelledError,决定是否继续清理

取消传播:子任务不会自动被取消

父协程被取消,其启动的子任务(如用 asyncio.create_task() 启动的)默认不会被取消——它们继续运行,可能造成资源泄漏或状态不一致。

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 显式跟踪子任务:保存 task 对象,在父协程的 finally 或 except asyncio.CancelledError: 中调用 task.cancel() 并 await asyncio.wait_for(task, timeout=1)
  • 用 asyncio.gather(..., return_exceptions=True) 启动多个任务,它会在任一子任务被取消时,自动尝试取消其余任务(但仍有竞态,需配合超时)
  • 避免用 asyncio.ensure_future() 替代 create_task():前者不绑定到当前事件循环上下文,取消行为更难预测

测试取消逻辑不能只靠 task.cancel()

直接调用 task.cancel() 只是设置取消标记,异常实际发生在下一次 await;如果协程已经结束或没 await,CancelledError 根本不会抛出。

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

  • 真实测试场景应让协程处于等待中:用 asyncio.sleep(10) 或 asyncio.Event().wait() 卡住,再 cancel
  • 用 asyncio.run_coroutine_threadsafe() + 线程 sleep + cancel,模拟并发取消更贴近生产环境
  • 注意 Python 3.11+ 引入了 asyncio.timeout() 上下文管理器,比手写 wait_for 更清晰,但底层仍依赖同一套取消机制

真正难的是清理逻辑本身是否幂等、是否持有锁、是否在取消途中又触发新 await——这些没法靠语法糖解决,得靠具体场景反复验证。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

4638

2023.08.10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

0

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

0

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架零基础入门教程
XORM框架零基础入门教程

本专题梳理XORM框架的入门路径,从框架定位、依赖安装、连接数据库到跑通第一个增删改查示例,讲清Engine初始化、日志开启与项目目录规划,并对比GORM等同类ORM的差异,帮助Go开发者建立整体认知。

0

2026.11.04

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn