根本原因是pytest默认不支持异步测试，需安装pytest-asyncio插件并配置asyncio_mode=auto或使用@pytest.mark.asyncio标记，否则async def测试函数会被静默跳过并报InvalidAsyncSpec警告。
Pytest 运行时出现 InvalidAsyncSpec 警告，根本原因是测试函数被标记为 async，但 pytest 默认不支持直接运行异步测试函数——它把 async 函数当成了普通协程对象，既没 await，也没用 async-compatible runner。
为什么 pytest 会报 InvalidAsyncSpec 而不是直接报错？
这个警告来自 pytest-asyncio 插件（或旧版 pytest 自带的异步探测逻辑），它在收集测试时发现函数是 async def 定义的，但当前配置没启用异步支持，于是跳过执行并发出警告。本质不是语法错误，而是「pytest 不知道该怎么处理这个 async 函数」。
- 未安装
pytest-asyncio：pytest 3.7+ 会识别 async 函数但拒绝运行，仅发警告 - 装了插件但没加
@pytest.mark.asyncio或没配asyncio_mode = auto - 函数用了
async def，但内部没任何await表达式（纯同步逻辑写成 async）——这虽合法，但触发无意义的异步标记
如何让 async 测试函数真正被运行？
必须显式告诉 pytest：「这个测试需要异步执行环境」。有两种主流方式，选其一即可：
- 在测试函数上加装饰器：
@pytest.mark.asyncio（推荐，粒度细、意图明确） - 在
pyproject.toml或pytest.ini中全局启用：asyncio_mode = auto（自动给所有async def test_*加 asyncio 标记）
示例：
立即学习“Python免费学习笔记（深入）”；
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
import pytest
@pytest.mark.asyncio
async def test_fetch_data():
result = await some_async_function()
assert result == "ok"
注意：@pytest.mark.asyncio 必须直接修饰测试函数，不能只修饰 fixture；且该装饰器依赖 pytest-asyncio 已安装并启用。
常见误配和静默失败场景
很多问题看起来没报错，但测试实际没跑、或结果不可靠：
- 装了
pytest-asyncio但忘记import pytest—— 装饰器不生效，@pytest.mark.asyncio变成无意义的普通装饰器 - 在
conftest.py里写了pytest_plugins = ["pytest_asyncio"]，但版本太老（asyncio_mode = auto - 测试函数用了
async def，但 await 的是同步函数（如await time.sleep(1)）——这会抛TypeError: object int can't be used in 'await' expression，和InvalidAsyncSpec无关，但容易混淆 - 使用
asyncio.run()在测试里手动驱动协程：绕过了 pytest 的事件循环管理，可能导致 fixture 生命周期错乱（比如 async fixture 没被正确 cleanup）
检查 await 调用是否匹配的关键点
async 函数里每个 await 后面的对象，必须是真正的可等待对象（Awaitable），常见陷阱：
-
await some_sync_function()→ 报错，同步函数返回值不是Awaitable -
await some_async_function（漏了括号）→ 报错，这是函数对象本身，不是调用结果 -
await asyncio.sleep(1)正确，但await time.sleep(1)错误（time.sleep是同步阻塞） - mock 异步函数时，用
AsyncMock而非Mock，否则await mock_obj()会失败
可以用 inspect.iscoroutinefunction() 或 inspect.isawaitable() 在调试时验证对象类型。
最常被忽略的是：警告本身不中断执行，但意味着你的 async 测试根本没跑——你以为通过了，其实 pytest 跳过了它。务必确认日志里有 collected 1 item 且运行时显示 . 或 F，而不是静默跳过。
