0

0

Python asyncio.wait() 和 asyncio.as_completed() 实际使用差异

冷炫風刃

冷炫風刃

发布时间:2026-01-25 02:29:29

|

954人浏览过

|

来源于php中文网

原创

asyncio.wait()适合统一控制超时与完成状态,返回(done, pending)并支持return_when精细调度;asyncio.as_completed()专为按完成顺序消费结果设计,返回异步迭代器,需async for逐个await。

python asyncio.wait() 和 asyncio.as_completed() 实际使用差异

asyncio.wait() 适合需要统一控制超时和完成状态的场景

当你需要等一批任务里「至少 N 个完成」,或者「全部完成 / 任意一个出错就停」,asyncio.wait() 是更直接的选择。它返回的是 (done, pending) 两个 set,你可以检查哪些已结束、哪些还在跑,还能配合 return_when 参数精细控制退出时机。

常见错误是默认用 return_when=asyncio.ALL_COMPLETED 却没处理 pending 里的 task —— 它们不会自动 cancel,可能持续占用资源甚至引发后续异常。

  • return_when=asyncio.FIRST_COMPLETED:拿到第一个结果就返回,适合“谁快用谁”逻辑
  • return_when=asyncio.FIRST_EXCEPTION:任一 task 抛出未捕获异常即返回,适合容错敏感场景
  • 必须手动调用 task.cancel()await asyncio.gather(*pending, return_exceptions=True) 清理挂起任务

asyncio.as_completed() 专为按完成顺序消费结果而生

asyncio.as_completed() 返回一个异步迭代器,每次 await 都得到「下一个最先完成」的 Task 的结果(不是 task 对象本身)。它不关心谁先启动、谁后启动,只管谁先 finish —— 这让并发请求+流式处理变得非常自然。

容易踩的坑是误以为它会自动 await 所有 task:它只是包装了等待逻辑,你仍需在循环里显式 await 每次迭代;另外,如果某个 task 永远不完成,迭代就会卡住(除非加 timeout)。

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

腾讯交互翻译
腾讯交互翻译

腾讯AI Lab发布的一款AI辅助翻译产品

下载
  • 返回值是 coroutine,必须用 async for 或逐个 await,不能直接 print
  • 无法得知哪个 task 对应哪个结果(除非你在创建 task 时绑定标识,比如用 asyncio.create_task(coro, name="req-1")
  • 内部会把所有 task 包装成 asyncio.ensure_future(),所以传入普通协程也 OK,但传入已运行的 Task 更安全

性能与取消行为差异直接影响错误处理方式

asyncio.wait() 在返回前,对已完成的 task 调用的是 task.result(),如果 task 已失败,这里会直接 re-raise 异常;而 asyncio.as_completed() 是在你 await 迭代项时才触发 result(),异常延迟暴露。

这意味着:用 wait() 时,你得在 try/except 里包住整个 await wait(...);用 as_completed() 时,异常要放在 async for 循环体内捕获。

  • wait()pending 集合里 task 仍处于运行中,cancel 后需额外 await 确保清理
  • as_completed() 不提供 pending 列表,也没法知道还有几个没完成,不适合做进度判断
  • 两者都不自动 suppress exception —— 如果你不显式处理失败 task,异常最终会冒泡到 event loop,触发 Task exception was never retrieved 警告

选哪个?看你要响应「完成事件」还是「完成结果」

如果你写的是监控脚本,要等 5 个健康检查里至少 3 个成功就上报状态,用 wait(return_when=asyncio.FIRST_COMPLETED) + 计数更清晰;如果你写的是爬虫,想一边收数据一边解析入库,as_completed() 配合 async for 就是天然流水线。

最易被忽略的一点:两者都依赖底层 task 的正确生命周期管理。传入已 cancel() 的 task、或忘了 await cleanup,都会导致 task 悬浮、event loop 关闭失败、甚至 Python 进程 hang 住。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的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的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

19

2026.02.03

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

38

2026.03.10

Kotlin Android模块化架构与组件化开发实践
Kotlin Android模块化架构与组件化开发实践

本专题围绕 Kotlin 在 Android 应用开发中的架构实践展开,重点讲解模块化设计与组件化开发的实现思路。内容包括项目模块拆分策略、公共组件封装、依赖管理优化、路由通信机制以及大型项目的工程化管理方法。通过真实项目案例分析,帮助开发者构建结构清晰、易扩展且维护成本低的 Android 应用架构体系,提升团队协作效率与项目迭代速度。

83

2026.03.09

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

97

2026.03.06

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

223

2026.03.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

458

2026.03.04

AI安装教程大全
AI安装教程大全

2026最全AI工具安装教程专题:包含各版本AI绘图、AI视频、智能办公软件的本地化部署手册。全篇零基础友好,附带最新模型下载地址、一键安装脚本及常见报错修复方案。每日更新,收藏这一篇就够了,让AI安装不再报错!

169

2026.03.04

热门下载

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

精品课程

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

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

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