为什么使用@pytest.mark.asyncio标记的pytest用例仍以同步模式运行而非异步模式?
你写的代码没有任何语法或逻辑问题,出现串行执行是pytest与pytest-asyncio的默认设计决定的:
- pytest原生的测试调度是纯同步流程:按收集到的顺序逐个跑测试,必须等上一个用例全部执行完、清理完关联资源,才会启动下一个,本身没有跨测试用例的并发调度能力。
- pytest-asyncio的默认实现完全对齐pytest的同步流程:碰到打了
@pytest.mark.asyncio标记的异步测试,就创建一个function作用域的独立事件循环,把当前测试的协程丢进去之后,阻塞等协程跑完,才把控制权交回pytest去处理下一个测试。
两套机制叠在一起,哪怕你的测试逻辑全是非阻塞的asyncio.sleep,两个协程也根本没机会被同一个事件循环同时调度——第一个测试的协程在循环里挂起等sleep结束时,pytest主流程正卡着等它跑完,根本走不到调度第二个测试的代码,最终自然是两个测试各跑5秒、总耗时10秒的串行效果。
结合你不手动重写event_loop fixture、使用默认内置实现的前提,有两类可落地的调整方式:
方案1:多进程跨用例并发(最简单,零自定义代码)
这是pytest生态里最通用的跨用例并发方案,完全不用改现有测试代码,也不会覆盖默认的event_loop实现:
- 安装并发测试插件:
pip install pytest-xdist - 跑测试的时候加启动参数:
pytest test_tmp.py -n 2
这个配置下,pytest-xdist会开两个独立的测试工作进程,每个进程分配一个测试用例,两个用例各自在自己的独立事件循环里跑asyncio.sleep(5),最终总耗时约5秒,完全符合你预期的“两个用例几乎同时启动运行”的效果。
提醒:多进程模式下每个工作进程是独立的Python解释器,涉及全局变量、固定端口、文件写入的测试要做好资源隔离,别出现跨进程的状态污染。
方案2:单进程单事件循环的真异步并发
要实现两个协程在同一个事件循环内调度并发,得把原来function级的独立循环,换成整个测试会话共用的session级循环。如果不想自己写fixture覆盖,可以直接用pytest-asyncio自带的配置完成:
在pytest配置文件(pytest.ini/pyproject.toml/setup.cfg)里加配置:
[pytest] # 把事件循环的默认作用域改成会话级,整个测试过程共用同一个循环 asyncio_default_fixture_loop_scope = session
注意:只改循环作用域还实现不了跨用例并发——因为pytest的同步调度逻辑还是会阻塞等当前测试跑完才跑下一个。要真正让同一循环内的协程跨测试用例并发调度,就得自己改调度逻辑,已经超出了“用默认fixture”的范畴。
常见认知误区
很多人会搞混“测试内部的异步并发”和“独立测试用例间的并发”:
如果你把两个测试的核心逻辑抽出来,在单个测试用例里用asyncio.gather并发执行,是可以直接跑通的,根本不需要额外配置,比如:
async def _case1_core(): logging.info(f"time => {time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(time.time()))}") await asyncio.sleep(5) async def _case2_core(): logging.info(f"time => {time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(time.time()))}") await asyncio.sleep(5) @pytest.mark.asyncio async def test_two_logic_concurrent(): await asyncio.gather(_case1_core(), _case2_core())
但这种写法的并发是单测试内部的逻辑并发,本质还是一个测试用例,不是两个独立测试用例的并发执行。
内容的提问来源于stack exchange,提问作者Silence He

