0

0

Python asyncio 任务取消的正确姿势

舞夢輝影

舞夢輝影

发布时间:2026-02-24 13:38:44

|

393人浏览过

|

来源于php中文网

原创

asyncio.create_task()后安全取消需调用task.cancel()并await task或asyncio.wait_for(),否则取消不生效;shield()仅拦截外部取消信号,不阻止内部取消;wait_for超时后须手动cancel并await清理;gather默认取消全部任务,需return_exceptions=true才隔离异常。

python asyncio 任务取消的正确姿势

asyncio.create_task() 后怎么安全取消

直接调用 task.cancel() 是唯一可靠方式,但必须配合 await taskasyncio.wait_for() 才能真正触发取消逻辑。不 await 的话,任务可能还在跑,只是被标记为“待取消”。

  • 取消后必须 await task,否则异常(CancelledError)不会抛出,协程也不会退出
  • 如果任务正在执行 CPU 密集型操作(比如没加 await asyncio.sleep(0) 的循环),cancel() 会失效——它只能在 await 点生效
  • 别用 task.done() 判断是否结束:刚调用 cancel() 时它返回 False,但任务其实已被中断;应检查 task.cancelled()

为什么 asyncio.shield() 会让 cancel 失效

asyncio.shield() 的作用是让被包裹的协程“免疫”外部取消,常用于清理逻辑或关键子任务。但它不是万能保护罩——如果被 shield 的协程自己主动 raise CancelledError,或者内部有未处理的取消传播,照样会退出。

  • shield() 只拦截父任务传来的取消信号,不阻止子任务内部的取消或超时
  • 常见误用:把整个主逻辑包进 shield(),结果取消完全不起作用,任务卡死
  • 正确用法只包裹真正不能中断的部分,比如 await db.close()await file.close()

asyncio.wait_for() 超时后任务没结束怎么办

asyncio.wait_for(task, timeout) 超时后,task 并不会自动取消,只是抛出 asyncio.TimeoutError。你得手动处理后续:要么 await task 等它自然结束,要么显式 task.cancel()

MusicLM
MusicLM

谷歌平台的AI作曲工具,用文字生成音乐

下载
  • 漏掉这一步会导致“幽灵任务”继续运行,占用资源、修改状态,甚至引发竞态
  • 推荐写法:
    try:
        result = await asyncio.wait_for(task, timeout=5)
    except asyncio.TimeoutError:
        task.cancel()
        await task  # 确保清理完成
    
  • 注意 wait_for 自身也会被外层取消,此时它内部的 task 不受影响,仍需单独处理

asyncio.gather() 中某个任务被取消,其他任务还继续吗

默认情况下,asyncio.gather() 遇到任一任务取消,会立即取消所有剩余任务。这是它的默认行为,不是 bug。

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

  • 想让其他任务继续运行,必须传 return_exceptions=True,这样取消会变成 CancelledError 实例,不中断整体执行
  • 但要注意:即使设置了 return_exceptions=True,被取消的任务也不会自动清理——你仍要检查结果里有没有 CancelledError,并决定是否 await 它做善后
  • 别依赖 gather 的“并发性”来规避取消影响,它的取消传播逻辑很坚决

取消不是发个信号就完事,关键是控制权交还给事件循环的时机,以及你是否真等到了那个 await 点。很多人卡在“调了 cancel 却没反应”,问题往往出在没 await,或者协程根本没 yield 控制权。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
苹果官网入口与在线访问指南_中国站点快速直达与iPhone查看方法
苹果官网入口与在线访问指南_中国站点快速直达与iPhone查看方法

本专题汇总苹果官网最新可用入口及中国站点访问方式,涵盖官网直达链接、iPhone官方页面查看方法与常见访问说明,帮助用户快速进入苹果官方网站,便捷了解产品信息与官方服务。

4

2026.02.24

Asianfanfics官网入口与访问指南_AFF官方平台最新登录地址
Asianfanfics官网入口与访问指南_AFF官方平台最新登录地址

本专题系统整理Asianfanfics(AFF)官方网站最新可用入口,涵盖官方平台最新直达地址、官网登录方式及中文访问指引,帮助用户快速、安全地进入AFF平台浏览与使用相关内容。

8

2026.02.24

Go分布式服务治理与链路追踪实践
Go分布式服务治理与链路追踪实践

本专题围绕 Go 语言在分布式系统中的服务治理实践展开,系统讲解服务注册与发现、配置中心、限流熔断、灰度发布以及分布式链路追踪方案。通过完整项目示例,帮助开发者构建可观测性完善、稳定性高、易扩展的 Go 微服务架构体系,提升线上系统问题定位与运维效率。

1

2026.02.24

Python自动化测试与持续集成实战
Python自动化测试与持续集成实战

本专题聚焦 Python 在自动化测试与持续集成中的工程化实践,系统讲解测试框架选型、测试用例设计、接口自动化、测试数据管理及测试报告生成。结合 CI/CD 流水线场景,讲解如何将自动化测试融入持续集成流程,实现代码提交即自动测试,提升项目交付质量与团队协作效率。

0

2026.02.24

Java高并发系统设计与性能调优
Java高并发系统设计与性能调优

本专题围绕 Java 在高并发业务场景下的系统设计与性能调优展开,系统讲解线程模型、并发容器、锁机制、异步编程及 JVM 性能调优思路。结合真实高并发业务场景,深入分析接口限流、线程池配置、热点资源优化与系统稳定性保障方案,帮助开发者构建高性能、高可用的 Java 后端系统。

3

2026.02.24

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

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

1256

2026.02.13

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

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

402

2026.02.13

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

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

252

2026.02.13

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

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

39

2026.02.13

热门下载

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

精品课程

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

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.7万人学习

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

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