必须配置 asyncio_mode="auto" 并使用 AsyncMock；否则 pytest 无法识别 async 测试、mock 不可 await，导致跳过或报错。
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() 必然失败，错误信息直指核心问题。
立即学习“Python免费学习笔记（深入）”；
唯一可靠方式是用 AsyncMock（Python 3.8+ 内置）：
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
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
<p>app = FastAPI()</p><p>@pytest.mark.anyio
async def test_home():
async with AsyncClient(transport=ASGITransport(app=app), base_url="<a href="https://www.php.cn/link/9688c999c6508777280b6e8074ad82fa">https://www.php.cn/link/9688c999c6508777280b6e8074ad82fa</a>") 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。其他所有问题，基本都是从这两条漏掉开始滚雪球的。
