Asyncio：如何提前检测未被await的协程？

编译时检测 #

Python作为动态类型语言，字节码编译阶段无法直接检测协程是否被正确await，但可以通过静态分析工具实现类编译时的提前检查：

• 使用mypy并开启严格模式（--strict），它能识别未被await的协程调用，在代码检查阶段就抛出错误。例如：

  async def my_coroutine():
      pass
  
  my_coroutine()  # mypy会提示：error: "coroutine" object is not subscriptable, use "await"
  

• 其他工具如pyright也支持这类静态检查，能在开发阶段提前发现问题。

将警告转为错误 #

如果希望这类警告直接触发错误（避免生产环境被忽略），可以通过两种方式实现：

1. 代码内配置警告过滤器：

   import warnings
   # 将指定的RuntimeWarning转为错误
   warnings.filterwarnings(
       "error",
       category=RuntimeWarning,
       message="coroutine was never awaited"
   )
   

   这样当协程未被await时，会直接抛出RuntimeError，而非警告，更容易被监控或错误捕获机制发现。
2. 环境变量全局配置：
   在启动Python应用时设置环境变量：

   export PYTHONWARNINGS="error::RuntimeWarning:coroutine was never awaited"
   

   这种方式无需修改代码，对整个Python进程生效。

优化警告报告方式 #

若不想转为错误，可通过自定义警告处理器提升警告的可见性：

• 将警告信息输出到独立的日志文件，避免被其他应用日志淹没；
• 用logging模块捕获警告，将其标记为高优先级日志（如ERROR级别），并发送到监控系统或告警渠道；
• 在终端输出时添加颜色标记（如红色），让警告更醒目，例如：

  import warnings
  import sys
  
  def colored_warning(message, category, filename, lineno, file=None, line=None):
      # 用红色输出警告
      sys.stderr.write(f"\033[91m{category.__name__}: {message}\033[0m\n")
  
  warnings.showwarning = colored_warning
  

内容的提问来源于stack exchange，提问作者Ramon Dias