0

0

Python 异步上下文管理器的使用场景

冷炫風刃

冷炫風刃

发布时间:2026-02-16 13:01:35

|

451人浏览过

|

来源于php中文网

原创

async with 不能套 sync 的 contextlib.contextmanager,因为后者返回同步生成器,其 enter 和 exit 非异步方法,不满足 async with 要求的 aenter 和 aexit 协议。

python 异步上下文管理器的使用场景

async with 为什么不能套 sync 的 contextlib.contextmanager

因为 contextlib.contextmanager 返回的是同步生成器,它产生的 __enter____exit__ 都是普通函数,无法 await。你写 async with 却传入一个同步上下文管理器,Python 会直接报 TypeError: async with requires an async context manager

常见错误现象:把原来用 with open(...)@contextmanager 写的资源管理逻辑,原封不动改成 async with,然后卡在启动阶段。

  • 必须用 async def 实现 __aenter____aexit__,且类要继承 abc.ABC 或至少提供这两个方法
  • 标准库中只有少数内置类型支持异步上下文,比如 aiofiles.openaiomysql.Poolhttpx.AsyncClient
  • 自己写时别漏掉 await —— 比如在 __aenter__ 里做连接初始化,不加 await 就会返回协程对象而非实际结果

async with 在数据库连接池里的典型误用

很多人以为只要用了 asyncpg.create_poolaiomysql.create_pool,就能随便 async with pool.acquire(),但其实 acquire 是协程,必须 await;而 async with 只接管上下文协议,不自动 await 右值表达式。

使用场景:想每次请求复用连接,又避免手动 close。

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

佳可商务购物程序 2004
佳可商务购物程序 2004

在原版的基础上做了一下修正评论没有提交正文的问题特价商品的调用连接问题去掉了一个后门补了SQL注入补了一个过滤漏洞浮动价不能删除的问题不能够搜索问题收藏时放入购物车时出错点放入购物车弹出2个窗口修正主题添加问题商家注册页导航连接问题销售排行不能显示更多问题热点商品不能显示更多问题增加了服务器探测 增加了空间使用查看 增加了在线文件编辑增加了后台管理里两处全选功能更新说明:后台的部分功能已经改过前台

下载
  • 正确写法是 async with await pool.acquire() as conn: —— 注意 awaitasync with 外层
  • 错误写法:async with pool.acquire() as conn:,这会让 acquire() 返回一个协程对象,触发 RuntimeWarning: coroutine 'Pool.acquire' was never awaited
  • 某些旧版驱动(如早期 aiomysql)的 acquire() 返回的是可等待对象,但没实现 __aenter__,强行 async with 会报 AttributeError: __aenter__

__aexit__ 里抛异常会导致 awaitable 被静默吞掉

如果在 __aexit__ 方法里主动 raise 异常,而调用方没有用 try/except 包住整个 async with 块,这个异常不会像同步那样中断后续代码流 —— 它会变成未处理的协程异常,在事件循环结束时才被打印(例如 uvicorn 日志末尾突然冒一行 Task exception was never retrieved)。

性能影响:这类异常不打断执行,但会污染日志、掩盖真正的问题源头。

  • __aexit__ 应该返回 True 来抑制异常,或返回 None/False 让异常继续向上冒泡
  • 别在 __aexit__ 里做耗时操作(比如发 HTTP 请求),否则会阻塞整个协程退出路径
  • 调试时可在 __aexit__ 开头加 print(f"exiting with {exc_type}, {exc_value}"),确认是否真被调用了

和 asyncio.timeout 搭配时要注意作用域嵌套顺序

asyncio.timeout 是个异步上下文管理器,但它只对「同一层级」的 await 表达式生效。如果你把它套在 async with 外面,超时会中断整个块;但如果放在里面,就只保底单次操作。

使用场景:防止数据库查询卡死,但又不想让连接释放也超时。

  • 推荐结构:async with pool.acquire() as conn:async with asyncio.timeout(5):await conn.fetch(...)
  • 反模式:async with asyncio.timeout(5): async with pool.acquire() as conn: —— 连接获取失败也会被 timeout 拦截,而 acquire 本身可能已经重试多次,此时 timeout 显得武断
  • 注意 asyncio.timeout 在 Python 3.11+ 才是稳定 API,旧版本要用 asyncio.wait_for 替代,但后者不是上下文管理器,不能直接用于 async with
事情说清了就结束。异步上下文管理器的关键不在语法多难,而在每个环节都得对齐「可等待性」——从入口的 await,到中间的 async def,再到出口的异常传播控制。漏掉任一环,问题都藏得深。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

12

2026.02.03

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

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

372

2023.06.29

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

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

2092

2023.08.14

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

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

355

2023.08.31

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

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

259

2023.09.05

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

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

329

2023.10.09

数据库对象名无效怎么解决
数据库对象名无效怎么解决

数据库对象名无效解决办法:1、检查使用的对象名是否正确,确保没有拼写错误;2、检查数据库中是否已存在具有相同名称的对象,如果是,请更改对象名为一个不同的名称,然后重新创建;3、确保在连接数据库时使用了正确的用户名、密码和数据库名称;4、尝试重启数据库服务,然后再次尝试创建或使用对象;5、尝试更新驱动程序,然后再次尝试创建或使用对象。

417

2023.10.16

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

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

145

2026.02.13

热门下载

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

精品课程

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

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

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

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