使用pytest测试Python异步函数时测试异常通过并报RuntimeWarning
嘿,我来帮你搞定这个问题!你遇到的情况其实很典型——测试本该失败却通过,还弹出协程未被await的警告,核心原因是你的异步测试函数根本没被真正执行起来,里面的断言代码压根没跑,自然不会触发失败。
问题根源
出现RuntimeWarning: coroutine was never awaited就说明pytest没有正确处理你的异步测试函数,把它当成了普通的同步函数执行。这时候async函数只会返回一个协程对象,不会执行内部的代码,所以哪怕你写了assert True == False这种必然失败的断言,也不会有任何反应,测试直接通过。
常见的触发原因有这几个:
- 没正确安装或启用
pytest-asyncio插件,导致@pytest.mark.asyncio装饰器失效 - pytest和pytest-asyncio版本不兼容
- 导入的
asynctest库和pytest-asyncio产生了冲突
解决方案
1. 确保pytest-asyncio正确安装
先执行这条命令确认插件已安装:
pip install pytest-asyncio
2. 验证测试代码能被执行
如果安装后还是有问题,可以尝试不用装饰器,改用asyncio.run()手动执行协程,确保测试逻辑能被运行:
import asyncio import pytest from Foo.bar import posts def test_get_post_exists(): async def run_test_logic(): returned_post = await posts.get_post('0') assert returned_post.id == 0 assert returned_post.text == 'Text for the post body.' assert True == False # 这条断言现在一定会触发失败 asyncio.run(run_test_logic())
运行这个测试,你应该能看到预期的失败结果,说明测试代码终于被执行了。
3. 排查版本或冲突问题
- 检查pytest和pytest-asyncio的版本兼容性:比如pytest 7.x需要搭配pytest-asyncio 0.20及以上版本,你可以通过
pip list查看版本,不合适的话就升级或降级。 - 尝试移除代码里的
import asynctest,因为asynctest的测试框架可能和pytest-asyncio产生冲突,导致异步测试被错误处理。
4. 强制启用pytest-asyncio插件
如果你的pytest配置文件(比如pytest.ini)不小心禁用了插件,可以在运行测试时强制指定启用:
pytest -p pytest_asyncio your_test_file.py
按照上面的步骤操作,你的测试应该就能正常执行,那个故意写的失败断言也会正确触发,警告也会消失啦。
内容的提问来源于stack exchange,提问作者Jones
相关产品推荐
相关产品推荐

