应配置pytest显示RuntimeWarning并定位漏await的协程：在pyproject.toml中设python_warnings=["default::RuntimeWarning"]，或命令行加-W default::RuntimeWarning，再用IDE检查和mypy插件强制校验。
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加警告过滤器的三种实操方式
推荐按优先级顺序尝试，从项目级配置到单测粒度控制：
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
- 在
pyproject.toml中全局启用（最省心）：[tool.pytest.ini_options] python_warnings = ["default::RuntimeWarning"]
- 命令行临时加参数（调试用）：
pytest -W default::RuntimeWarning - 单个测试函数内屏蔽（慎用，仅限已知安全的遗留代码）：
@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请求根本没发出去。别让它安静地消失。
