Python协程异常不抛出_任务未await导致异常被吞噬的排查方法及add_done

协程函数未await会导致异常静默丢失，因协程对象未被调度或回收时异常被丢弃；add_done_callback对原始协程无效，仅适用于Task；应启用asyncio.debug、全局异常钩子及类型检查从源头防范。

python协程异常不抛出_任务未await导致异常被吞噬的排查方法及add_done_callback

协程函数没await，异常直接消失

Python协程里调用 async def 函数但忘了 await，它不会报错，只会返回一个 coroutine 对象——而这个对象如果没人消费，里面抛的异常就彻底丢弃。你看到程序“静默失败”，日志里连 traceback 都没有。

典型场景：在同步代码里直接调用异步函数（比如 fetch_data() 而不是 await fetch_data()），或漏掉循环里的 await
异常吞噬发生在事件循环退出前未调度该协程，或协程被 gc 回收时触发 __del__ 打印警告（但仅限 debug 模式）
CPython 3.12+ 默认开启 asyncio.debug=True 时，会打印 RuntimeWarning: coroutine 'xxx' was never awaited；旧版本默认不提示

示例：

async def risky():<br>    raise ValueError("boom")<br><br># ❌ 静默失效<br>risky()  # 返回 coroutine 对象，异常不触发

add_done_callback 为什么抓不到异常

add_done_callback 是给 Task 或 Future 绑定回调，但它只在任务“完成”后触发——而没 await 的协程根本不会变成 Task，更不会完成。所以你对原始协程对象调用 add_done_callback 是无效的，方法不存在，会报 AttributeError。

只有显式用 asyncio.create_task() 或 loop.create_task() 包装，才得到可绑定回调的 Task 实例
直接对协程对象调 add_done_callback：报错 AttributeError: 'coroutine' object has no attribute 'add_done_callback'
即使你误写成 asyncio.create_task(risky()).add_done_callback(...)，也只对那个 Task 生效；但原始漏 await 的调用点依然存在，异常照吞

怎么快速定位漏 await 的协程调用

靠肉眼扫代码不可靠，尤其在大型项目或动态调用路径里。真正有效的办法是启用 asyncio 的异常钩子 + 启动时强制 debug 模式。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

启动时加环境变量：PYTHONASYNCIODEBUG=1，或代码开头设 asyncio.get_event_loop().set_debug(True)

安装全局异常钩子捕获未处理的协程异常：

<pre class="brush:php;toolbar:false;">def handle_coro_exception(loop, context):<br>    if "exception" in context:<br>        print("Uncaught in task:", context.get("exception"))<br>loop.set_exception_handler(handle_coro_exception)

用 pytest-asyncio 运行测试时，加上 --asyncio-mode=auto 和 -W default::RuntimeWarning 可暴露所有未 await 警告
注意：某些 IDE（如 PyCharm）的调试器会自动 await 协程用于变量求值，导致你在断点里看不到异常——换终端运行验证

正确做法：从源头堵住漏 await

别依赖事后补救。协程调用必须明确区分“发起”和“等待”，漏掉任一环节都可能让异常沉底。

所有 async def 函数调用处，检查是否在 async 函数内且用了 await；若在同步函数里，必须用 asyncio.run() 或 loop.run_until_complete() 包一层
避免在构造函数、__init__、信号处理、atexit 等同步上下文中直接调协程——这类地方几乎不可能合法 await
用类型检查工具辅助：mypy + mypy-extensions 可识别 Coroutine 类型未被 await；pyright 也能标出 “Expected awaitable” 提示
CI 中加检查：用 grep -r "def.*async" . | grep -v "await" 做粗筛（不完美但有用）