0

0

Python 异步异常传播的常见陷阱

舞夢輝影

舞夢輝影

发布时间:2026-02-19 16:31:03

|

116人浏览过

|

来源于php中文网

原创

async/await异常不会自动冒泡,未await的协程异常会静默滞留;task.cancel()仅设标记需手动响应;gather()默认传播首个异常;未读取task.exception()会导致异常隐藏。

python 异步异常传播的常见陷阱

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

调用 async 函数返回的是一个 coroutine 对象,不是立即执行——这意味着你没 await 它,异常根本不会抛出,连 traceback 都看不到。常见于忘记 await 一个异步函数,或者误把它当同步函数直接调用。

实操建议:

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

  • 所有 async 函数调用必须显式 await,除非你明确要延迟执行(比如放进 asyncio.create_task()
  • pytestunittest 测试异步函数时,测试方法本身也得是 async def 并用 await 调用被测函数
  • PyCharm 和 VS Code 的 linter(如 Pylint、Ruff)能识别未 await 的 coroutine,开启 async-await 相关检查项

Task.cancel() 不会立即终止协程执行

asyncio.Task.cancel() 只是设个标记并抛出 CancelledError,协程得自己响应这个异常才能退出。如果协程里有阻塞调用(比如没加 timeout 的 await asyncio.sleep() 或网络请求),它可能卡住,甚至让整个事件循环僵住。

实操建议:

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

  • 在关键协程中用 try/except CancelledError 捕获,并做清理(如关闭连接、释放资源)
  • 避免在 finally 块里写耗时操作;若必须,用 asyncio.wait_for(..., timeout=...) 包裹
  • 取消后记得 await task 等待它真正结束,否则 CancelledError 会被压制,后续无法感知是否已清理完成

asyncio.gather() 默认不传播异常

asyncio.gather(*coros, return_exceptions=False) 在任一子协程出错时,会立刻取消其余任务,并把第一个异常原样抛出——但前提是没设 return_exceptions=True。很多人开了这个参数却忘了处理返回值里的 Exception 实例,结果逻辑静默失败。

Molica AI
Molica AI

一款聚合了多种AI工具的一站式创作平台

下载

实操建议:

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

  • 默认保持 return_exceptions=False,让异常尽早暴露;仅在“允许部分失败”场景才开它
  • 若开了 return_exceptions=True,务必检查每个返回值:isinstance(x, Exception),不能直接解包或调用方法
  • asyncio.gather() 的异常类型和堆栈深度受子协程影响,调试时注意看 __cause____context__

未 await 的异常会滞留在 Task 对象里

asyncio.create_task() 启动协程后,如果不 await 它、也不调用 task.exception(),里面发生的异常就一直挂着,既不打印也不传播。Python 3.12 开始会在解释器退出时警告,但更早版本完全静默。

实操建议:

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

  • 所有 create_task() 后,要么 await task,要么至少调用 task.exception() 主动读取一次
  • 生产环境建议用 asyncio.create_task(..., name="xxx") 命名任务,方便日志追踪和调试
  • 别依赖 asyncio.all_tasks() 手动轮询——容易漏掉刚创建还没调度的 task,优先用结构化并发(如 asyncio.TaskGroup

异步异常最麻烦的不是它多难捕获,而是它能在你完全没察觉的情况下消失或错位。尤其要注意那些“看起来运行了但没报错”的协程——它们很可能正带着异常卡在某个 Task 里,等你重启服务时才突然爆发。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

419

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

594

2023.08.10

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

419

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

594

2023.08.10

pycharm怎么改成中文
pycharm怎么改成中文

PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具,比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外,该IDE提供了一些高级功能,以用于支持Django框架下的专业Web开发。php中文网给大家带来了pycharm相关的教程以及文章,欢迎大家前来学习和阅读。

229

2023.07.25

pycharm安装教程
pycharm安装教程

PyCharm是一款由JetBrains开发的Python集成开发环境(IDE),它提供了许多方便的功能和工具。本专题为大家带来pycharm安装教程,帮助大家解决问题。

209

2023.08.21

如何解决pycharm找不到模块
如何解决pycharm找不到模块

解决pycharm找不到模块的方法:1、检查python解释器;2、安装缺失的模块;3、检查项目结构;4、检查系统路径;5、使用虚拟环境;6、重启PyCharm或电脑。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

662

2023.12.04

如何安装pycharm
如何安装pycharm

安装pycharm的步骤:1、访问PyCharm官方网站下载最新版本的PyCharm;2、下载完成后,打开安装文件;3、安装完成后,打开PyCharm;4、在PyCharm的主界面中等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

152

2024.02.23

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

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

660

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新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号