pytest运行时出现“coroutine ''xxx'' was never awaited”警告怎么办

这个警告不是错误，但说明有协程对象被创建后彻底丢弃了——它不会执行、不抛异常、不发请求，只在GC时悄悄报一句RuntimeWarning。pytest默认不显示这类警告，所以你可能根本没看见；一旦开启，大量测试用例会突然刷屏。

为什么pytest默认不报这个警告

pytest默认只捕获DeprecationWarning和FutureWarning，而RuntimeWarning（包括未await协程的警告）被静默忽略。这不是bug，是设计选择：避免测试框架被非致命运行时提示干扰。

Python自身在垃圾回收协程对象时才触发该警告，所以必须确保协程变量作用域结束（比如函数返回、局部变量被覆盖）

pytest若未显式配置，连-W default参数也不会透传给子进程或fixture内部

使用asyncio.run()包裹的顶层协程，其内部漏await的子协程仍会被警告——但pytest不拦，就直接刷到终端

给pytest加警告过滤器的三种实操方式

推荐按优先级顺序尝试，从项目级配置到单测粒度控制：

在pyproject.toml中全局启用（最省心）：复制AI写代码

[tool.pytest.ini_options]

python_warnings = ["default::RuntimeWarning"]

命令行临时加参数（调试用）：pytest -W default::RuntimeWarning

单个测试函数内屏蔽（慎用，仅限已知安全的遗留代码）：复制AI写代码

@pytest.mark.filterwarnings("ignore::RuntimeWarning")

def test_legacy_async_call():

some_old_async_func() # 明知漏await，但暂时不改

比过滤更关键的是定位源头

警告本身只是症状。真正要解决的是“哪个调用点漏了await”。光靠pytest过滤器掩盖问题，下次CI可能因新协程引入又爆出来。

PyCharm里打开Settings → Editor → Inspections → Python → Coroutine is not awaited，能实时标出黄色波浪线

VS Code装Pylance插件后，默认启用reportUnusedCoroutine检查

CI阶段加强制检查：在pyproject.toml里配mypy插件mypy-extensions，启用disallow_unawaited_coroutines = true

注意asyncio.create_task()和asyncio.gather()也算合法消费，不触发警告；但list(map(my_async_func, items))这种写法会生成一堆未await协程对象，必须改成await asyncio.gather(*[my_async_func(x) for x in items])

协程警告容易被当成噪音关掉，但它背后往往是逻辑失效——比如数据库没写入、HTTP请求根本没发出去。别让它安静地消失。