Python异步上下文管理器是高效处理异步资源（如网络连接、数据库会话）的关键机制，它通过实现`__aenter__`和`__aexit__`两个必需的异步方法，配合`async with`语法实现非阻塞的资源获取与自动清理；文章不仅详解其核心原理与强制规范（如必须使用`async def`、不可混用同步协议），还提供了手写类和`@asynccontextmanager`装饰器两种实用实现方式，并直击常见陷阱——比如在协程中误用阻塞调用、在同步函数里滥用`async with`等，帮你避开事件循环卡死和运行时错误，真正写出健壮、可维护的异步代码。

Python 异步上下文管理器通过 async with 语句使用，其核心是实现 __aenter__ 和 __aexit__ 两个异步方法，二者都必须是协程函数（用 async def 定义）。

基本实现结构

一个合法的异步上下文管理器类需满足：

• __aenter__ 返回进入上下文时的值，可以是任意对象（包括协程结果），通常用于异步资源获取（如打开网络连接、数据库会话）
• __aexit__ 接收异常三元组 (exc_type, exc_value, traceback)，返回 True 表示已处理异常、不向外传播；返回 None 或 False 则异常继续传播
• 两个方法都必须用 async def 声明，不可用 await 普通生成器或同步方法模拟

完整可运行示例

以下是一个模拟异步文件读取的简单异步上下文管理器：

import asyncio
<p>class AsyncFile:
def <strong>init</strong>(self, path):
self.path = path
self._file = None</p><pre class="brush:python;toolbar:false;">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，避免手动写类：

from contextlib import asynccontextmanager
import asyncio
<p>@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)</p><h1>使用</h1><p>async def use_db():
async with db_connection() as conn:
print("Using", conn)</p><p>asyncio.run(use_db())
</p>

装饰器将普通异步生成器自动转为异步上下文管理器：yield 前的部分对应 __aenter__，yield 后（finally 中）对应 __aexit__ 的清理逻辑。

注意事项与常见误区

使用时需注意：

• async with 只能在 async def 函数内使用，不能在同步函数或模块顶层直接写
• __aenter__ 和 __aexit__ 中若调用阻塞 I/O（如 time.sleep、普通 open()），会阻塞事件循环，应改用异步等价物（如 asyncio.sleep、aiofiles.open）
• 异步上下文管理器不能替代同步版本（__enter__/__exit__），二者互不兼容；混用会导致 RuntimeError 或静默失败
• 若需同时支持同步和异步（如库设计），需分别实现两套协议，或用适配层封装

以上就是《Python异步上下文管理器实现方法》的详细内容，更多关于的资料请关注golang学习网公众号！