Python异步测试难mock？pytest-asyncio轻松搞定

Python异步测试常因配置缺失和Mock误用而频频报错——不启用`asyncio_mode="auto"`会导致async测试被跳过或提示“not a coroutine”，不用`AsyncMock`而用普通`Mock`则必然触发`TypeError: object can't be used in 'await'`；本文直击痛点，详解如何通过正确配置`pyproject.toml`、精准打补丁路径、规范使用`AsyncMock`与`ASGITransport`等关键实践，彻底规避事件循环冲突、静默失败、状态泄漏等高频陷阱，让异步测试真正稳定、简洁、可维护。

pytest-asyncio 不配 asyncio_mode 就等于没装

插件安装了但测试函数被跳过或报 not a coroutine，大概率是缺配置。pytest 原生不识别 async def，pytest-asyncio 插件必须通过 asyncio_mode 显式启用协程调度逻辑。不配就和没装一样——它不会自动接管测试函数。

必须在项目根目录放 pyproject.toml，内容含：

[tool.pytest.ini_options]
asyncio_mode = "auto"

auto 模式下，所有 async def test_* 会被自动识别并 await 执行；若用 strict，则每个函数都得加 @pytest.mark.asyncio，新手容易漏标、白写。

• 别用 pytest.ini：虽能用，但 pyproject.toml 是当前事实标准，且某些旧版 pytest 对 ini 文件解析不稳定
• 别信“装了就自动生效”：插件加载 ≠ 功能启用，asyncio_mode 是开关，不是可选项
• 验证是否生效：运行 pytest --co，输出里应有 async 字样；再跑 pytest -v，状态应为 . 而非 s（skipped）

mock 异步函数时用 Mock 就会 TypeError: object MagicMock can't be used in 'await'

普通 Mock() 返回的是同步对象，不能被 await。打补丁后调用 await mock_func() 必然失败，错误信息直指核心问题。

唯一可靠方式是用 AsyncMock（Python 3.8+ 内置）：

from unittest.mock import AsyncMock
mock_fetch = AsyncMock(return_value={"data": "ok"})
with patch("myapp.api.fetch_data", mock_fetch):
    result = await target_function()

• 别 patch 错路径：优先 patch 被测函数内部 import 的位置，比如 @patch("myapp.service.do_request")，而不是 aiohttp.ClientSession.get
• 别设 mock.return_value 为最终值：它返回的是协程，await mock() 才拿到 return_value；若要抛异常，用 mock.side_effect = ValueError("boom")
• 别混用 Mock 和 AsyncMock：哪怕只有一处用错，整个测试链就断

测试里手动调用 asyncio.run() 会触发 RuntimeError: cannot be called from a running event loop

pytest-asyncio 已管理好事件循环生命周期，你再调 asyncio.run() 就等于在已有循环里硬启新循环——Jupyter 里常见，测试里也高频。

正确写法就是直接 await：

async def test_process_item():
    result = await process_item("abc")  # ✅
    assert result == "processed"

• 别写 result = process_item("abc")（漏 await）：这只会创建协程对象，断言时类型对不上
• 别写 result = asyncio.run(process_item("abc"))：pytest 已启动循环，重复调用必报错
• 别在测试里自己建 loop：比如 asyncio.new_event_loop()，和 pytest 的 event loop 冲突，资源清理易出错

FastAPI 异步测试必须用 AsyncClient + ASGITransport

用 TestClient 测异步路由会静默失败或返回空响应，因为它底层是同步 httpx.Client，无法驱动 async def 路由函数。

必须用 AsyncClient 并配 ASGITransport：

from httpx import ASGITransport, AsyncClient
from fastapi import FastAPI
app = FastAPI()
@pytest.mark.anyio
async def test_home():
async with AsyncClient(transport=ASGITransport(app=app), base_url="http://test") as ac:
response = await ac.get("/")
assert response.status_code == 200

• 别漏 @pytest.mark.anyio：虽然 pytest-asyncio 也能跑，但 anyio 更适配 FastAPI 的底层运行时，兼容性更稳
• 别省 transport=ASGITransport(app=app)：缺这个，AsyncClient 会走真实网络请求
• 别复用 client 实例：每个测试用 async with 确保隔离，避免连接/状态泄漏

关键点其实就两个：配置开关必须开，mock 对象必须可 await。其他所有问题，基本都是从这两条漏掉开始滚雪球的。

到这里，我们也就讲完了《Python异步测试难mock？pytest-asyncio轻松搞定》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！