Python异步上下文管理器需实现__aenter__和__aexit__两个async方法，用于异步资源获取与清理；支持async with语法，不可在同步函数中使用，且不能与同步上下文管理器混用。
Python 异步上下文管理器通过 async with 语句使用，其核心是实现 __aenter__ 和 __aexit__ 两个异步方法，二者都必须是协程函数（用 async def 定义）。
基本实现结构
一个合法的异步上下文管理器类需满足：
-
__aenter__返回进入上下文时的值，可以是任意对象（包括协程结果），通常用于异步资源获取（如打开网络连接、数据库会话） -
__aexit__接收异常三元组(exc_type, exc_value, traceback)，返回True表示已处理异常、不向外传播；返回None或False则异常继续传播 - 两个方法都必须用
async def声明，不可用await普通生成器或同步方法模拟
完整可运行示例
以下是一个模拟异步文件读取的简单异步上下文管理器：
import asyncioclass AsyncFile: def init(self, path): self.path = path self._file = None
async def __aenter__(self): # 模拟异步打开：实际中可能是 aiofiles.open() await asyncio.sleep(0.1) self._file = f"Async file handle for {self.path}" return self._file async def __aexit__(self, exc_type, exc_value, traceback): # 模拟异步关闭 await asyncio.sleep(0.05) self._file = None # 若有异常，可在此记录或抑制 if exc_type is not None: print(f"Exception caught: {exc_type.__name__}: {exc_value}") return False # 不抑制异常，让调用方感知使用方式
async def main(): async with AsyncFile("data.txt") as f: print("Inside context:", f)
raise ValueError("test error") # 可取消注释测试异常处理
asyncio.run(main())
配合 asynccontextmanager 装饰器简化写法
对于简单逻辑，推荐使用
contextlib.asynccontextmanager，避免手动写类：立即学习“Python免费学习笔记（深入）”；
from contextlib import asynccontextmanager import asyncio@asynccontextmanager async def db_connection(): print("Connecting...") await asyncio.sleep(0.1) try: yield "DB connection object" finally: print("Disconnecting...") await asyncio.sleep(0.05)
使用
async def use_db(): async with db_connection() as conn: print("Using", conn)
asyncio.run(use_db())
装饰器将普通异步生成器自动转为异步上下文管理器：
yield前的部分对应__aenter__，yield后（finally中）对应__aexit__的清理逻辑。注意事项与常见误区
使用时需注意：
-
async with只能在async def函数内使用，不能在同步函数或模块顶层直接写 -
__aenter__和__aexit__中若调用阻塞 I/O（如time.sleep、普通open()），会阻塞事件循环，应改用异步等价物（如asyncio.sleep、aiofiles.open） - 异步上下文管理器不能替代同步版本（
__enter__/__exit__），二者互不兼容；混用会导致RuntimeError或静默失败 - 若需同时支持同步和异步（如库设计），需分别实现两套协议，或用适配层封装
