async函数异常“消失”是因为协程未被await执行；漏await、task未处理、未调用get()等导致异常被静默吞没，需主动await、检查task.exception()或启用debug模式捕获。

async 函数里的异常“消失”，不是代码没出错，而是它根本没机会跑出来。关键原因只有一个：协程对象被创建了，但没被调度执行——没 await，异常就卡在协程里，没人触发，也没人看见。

漏掉 await 是最常见原因

调用 async 函数却不加 await，Python 只是返回一个 coroutine 对象，不会执行函数体，更不会抛异常：

• 错误写法：fetch_data() → 返回 coroutine，内部 raise ValueError 完全静默
• 正确写法：await fetch_data() → 协程真正运行，异常立刻浮现
• 常见高危场景：同步函数里误调异步函数、for 循环中漏写 await、条件分支里某条路径没 await

Task 创建后没处理生命周期

用 asyncio.create_task() 启动任务，不等于异常自动浮现。任务若未被 await 或检查，异常会留在 task 对象里：

Nutrient Document Processing (Universal Agent Skill)

一款AI办公效率工具，主要用于适用于兼容 Agent Skills 产品的通用（非 OpenClaw）Nutrient DWS 文档处理技能。最佳搭配：Claude Code、Codex CLI、Gemini CLI、Cursor、Wi...，适合需要提升相关任务效率的用户。

下载

• task.exception() 可安全读取异常（不抛出），适合日志监控或延迟处理
• await task 会把异常原样抛出，适合需要立即响应的流程
• 程序退出前未 await 任务 → 异常丢失，且 CPython 3.12+ 会在 debug 模式下警告 “coroutine was never awaited”

启用调试与全局兜底机制

靠人工检查容易遗漏，要用工具提前拦截：

• 启动时加 asyncio.run(main(), debug=True)，未 await 的协程会触发 RuntimeWarning
• 设置事件循环异常处理器，捕获未被 await 的 task 异常：
  loop.set_exception_handler(custom_handler)
• 避免使用 add_done_callback 绑定原始协程（无效！只对 Task/Future 生效）

DisposeAsync 和多播委托也存在同类问题

不只是 Python，其他语言的异步资源清理和事件通知同样敏感：

• IAsyncDisposable.DisposeAsync() 若在 await using 中执行失败，异常可能被吞；建议手动调用并 try-catch
• C# 多播委托直接 Invoke()，任一订阅方法抛异常，后续方法全跳过；应改用 GetInvocationList() 逐个 try-catch
• std::async 的 future 必须调用 get() 才能触发异常重抛，仅 wait() 不够