0

0

Python 异步代码的异常传播机制

舞姬之光

舞姬之光

发布时间:2026-02-21 17:27:24

|

328人浏览过

|

来源于php中文网

原创

async/await异常不会自动冒泡,必须显式调度协程(如await、asyncio.run)或检查task(如task.exception())才能捕获;gather默认快速失败,需return_exceptions=true才聚合异常;未处理异常会在event loop关闭时转为runtimeerror输出到stderr。

python 异步代码的异常传播机制

async/await 中的异常不会自动冒泡到外层同步代码

你写了个 async def,里面 raise ValueError("boom"),但调用它时没加 await 或没用 asyncio.run(),结果异常根本没抛出来——不是没发生,是它卡在了 coroutine object 里,等着被驱动执行。Python 不会主动执行协程,也不会替你检查它内部有没有异常。

常见错误现象:RuntimeWarning: coroutine 'xxx' was never awaited,或者更隐蔽的:程序静默退出,日志里啥也没有。

  • 必须显式调度协程:用 await(在另一个 async 函数内)、asyncio.run()(顶层入口)、或 loop.run_until_complete()
  • 直接打印或返回协程对象(比如 print(fetch_data()))不会触发执行,自然也捕获不到异常
  • 单元测试里如果忘了 await 被测协程,断言会永远不运行,甚至可能误判为“通过”

Task 对象的异常要 await 才能触发

asyncio.create_task() 启动一个任务后,它的异常不会立刻向上抛,而是“挂起”在 Task 实例上,直到你对它做 await task 或调用 task.result()

使用场景:并发发多个请求,其中一个失败,但你不希望整个流程被中断,而是等全部结束再统一处理错误。

立即学习Python免费学习笔记(深入)”;

Android AsyncChannel源码分析 WORD版
Android AsyncChannel源码分析 WORD版

本文档主要讲述的是Android AsyncChannel源码分析;AsyncChannel类用于处理两个Handler之间的异步消息传递,消息传递的Handler可以出于同一进程,也可以处于不同进程,不同进程之间的Handler消息传递使用Android的Binder通信机制来实现。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看

下载
  • await task 会立即抛出该任务内部的异常(如果有的话)
  • task.exception() 可以安全获取异常对象(返回 None 表示没异常),适合非阻塞检查
  • 如果任务已取消,task.exception() 返回 CancelledError;但 await task 会直接 raise 它,需注意是否要捕获
  • 忘记 await 已创建的 task,可能导致异常丢失、资源未释放,且难以 debug

asyncio.gather() 的异常传播策略:默认“快速失败”

asyncio.gather() 默认只要有一个子协程出错,就立刻停止其余任务并抛出异常——这和你直觉中“等所有都跑完再汇总错误”不一样。

参数差异:return_exceptions=True 是关键开关,它让失败的子协程返回异常实例而非抛出。

  • 默认行为(return_exceptions=False):第一个异常中断整个 gather,其他协程可能被取消(取决于是否已开始执行)
  • 设为 True 后,所有结果(含 Exception 实例)按原顺序返回,你需要手动检查每个元素是不是异常
  • 性能影响:设为 True 不影响并发度,但会多保留异常对象,内存开销略增
  • 容易踩的坑:以为 gather 天然聚合异常,结果线上某个请求失败导致整批请求被截断

未捕获的异步异常会变成 RuntimeError 并打印到 stderr

当一个 task 内部抛出异常,又没人 await 它、也没人调用 task.exception(),Python 会在 event loop 关闭时把它作为“未处理异常”兜底处理:转成 RuntimeError,附带原始异常信息,输出到 stderr,但不中断主流程。

这种异常很难被日志框架捕获,也不进 except 块,常出现在后台任务、信号处理、或忘记清理的 task 中。

  • 可通过 loop.set_exception_handler() 自定义处理逻辑(比如上报 Sentry)
  • 开发期建议开启 asyncio.get_event_loop().set_debug(True),它会让这类异常立刻报 Warning,而不是等到 loop 结束
  • 生产环境别依赖 stderr 日志——它可能被重定向、截断,或和其它输出混在一起
  • 最稳妥的做法:所有 create_task() 都配个 done callback 或包一层带日志的 wrapper

异步异常真正的复杂点不在语法,而在于“谁负责驱动、谁负责检查、谁负责清理”这三件事经常被拆开在不同模块里。一个 Task 创建于 A 模块,await 在 B 模块,错误处理逻辑在 C 模块——这时候异常传播路径就变成了协作契约,不是语言机制能兜住的。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

13

2026.02.03

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

796

2026.02.13

微博网页版主页入口与登录指南_官方网页端快速访问方法
微博网页版主页入口与登录指南_官方网页端快速访问方法

本专题系统整理微博网页版官方入口及网页端登录方式,涵盖首页直达地址、账号登录流程与常见访问问题说明,帮助用户快速找到微博官网主页,实现便捷、安全的网页端登录与内容浏览体验。

272

2026.02.13

Flutter跨平台开发与状态管理实战
Flutter跨平台开发与状态管理实战

本专题围绕Flutter框架展开,系统讲解跨平台UI构建原理与状态管理方案。内容涵盖Widget生命周期、路由管理、Provider与Bloc状态管理模式、网络请求封装及性能优化技巧。通过实战项目演示,帮助开发者构建流畅、可维护的跨平台移动应用。

143

2026.02.13

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

25

2026.02.13

Redis高可用架构与分布式缓存实战
Redis高可用架构与分布式缓存实战

本专题围绕 Redis 在高并发系统中的应用展开,系统讲解主从复制、哨兵机制、Cluster 集群模式及数据分片原理。内容涵盖缓存穿透与雪崩解决方案、分布式锁实现、热点数据优化及持久化策略。通过真实业务场景演示,帮助开发者构建高可用、可扩展的分布式缓存系统。

92

2026.02.13

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

53

2026.02.12

雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法
雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法

本专题系统整理雨课堂网页版官方入口及在线登录方式,涵盖账号登录流程、官方直连入口及平台访问方法说明,帮助师生用户快速进入雨课堂在线教学平台,实现便捷、高效的课程学习与教学管理体验。

15

2026.02.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号