async with 是 Python 异步上下文管理语法,需配合实现 aenter 和 aexit 的异步管理器,在 async def 中使用,支持 await 初始化与清理,不可混用同步管理器。

async with 是 Python 中用于异步上下文管理的语法,专门配合实现了 __aenter__ 和 __aexit__ 方法的异步上下文管理器使用,适用于需要异步初始化和清理资源的场景(比如异步数据库连接、HTTP 客户端会话、文件读写等)。
async with 的基本用法
它和同步的 with 语义一致,但整个进入和退出过程都支持 await:进入时调用 __aenter__ 并 await,退出时调用 __aexit__ 并 await。不能混用同步与异步管理器。
- 必须在
async def函数内使用 - 不能直接在模块顶层或普通函数中写
async with - 支持
as绑定返回值(通常是 await__aenter__的结果)
如何自定义异步上下文管理器
只需在类中实现两个异步方法:
-
async def __aenter__(self):—— 返回要绑定的对象(如连接实例),可在此处 await 建立连接 -
async def __aexit__(self, exc_type, exc_val, exc_tb):—— 执行清理逻辑(如关闭连接),接收异常信息,返回True可抑制异常
例如:一个模拟异步数据库连接管理器
立即学习“Python免费学习笔记(深入)”;
常见适配 async with 的第三方库
很多现代异步库已内置支持:
-
aiohttp.ClientSession():用于异步 HTTP 请求 -
aiomysql.Pool()或asyncpg.Pool():异步数据库连接池 -
aiofiles.open():异步文件操作(需安装aiofiles) -
anyio.open_file()(viaanyio):跨后端的异步文件接口
注意事项与易错点
实际使用中容易忽略的关键细节:
- 忘记加
await在__aenter__/__aexit__内部 —— 这会导致协程对象未被调度执行 - 误把同步管理器(如普通
open())放进async with—— 会报TypeError: object X is not an async context manager - 在
__aexit__中未正确处理异常传播逻辑,导致错误被静默吞掉或资源未释放 - 嵌套多个
async with时未注意执行顺序(外层先 enter,内层后 enter;退出则相反)










