Python asyncio introspection 怎样定位当前任务
在 Python 的 asyncio 协程里,想知道“当前这段代码属于哪个任务”,直接调用 asyncio.current_task()。它返回当前正在运行的 Task;如果代码并不在 Task 中运行,则返回 None。需要查看同一个事件循环里还有哪些任务没有结束,再使用 asyncio.all_tasks()。
这两个 API 解决的是不同范围的问题:current_task() 适合给日志、超时处理和上下文诊断补上当前任务身份;all_tasks() 适合在一个受控的调试入口列出任务集合。Python 3.14 还增强了 asyncio 的进程级观察能力,但本文先把应用内最小定位链路讲清楚。
官方文档:https://docs.python.org/3.14/library/asyncio-task.html
- 当前协程对应的任务用
asyncio.current_task();没有运行中的 Task 时要接受None。 - 全量观察用
asyncio.all_tasks(),它返回的是当前循环中尚未完成任务的集合。 - 任务名用于区分身份,
get_coro()用于了解封装的协程,get_stack()用于查看挂起位置。
先分清“当前任务”和“所有未完成任务”
current_task() 的返回值是一个具体 Task,不是协程函数,也不是任务名字符串。它默认从当前运行循环取得上下文,因此最常见的调用位置就是 async def 函数内部。相反,all_tasks() 返回一个集合,集合里是当前事件循环中尚未完成的 Task。
| API | 定位范围 | 典型用途 | 需要注意 |
|---|---|---|---|
current_task() | 一个当前 Task | 给日志附加任务身份 | Task 外返回 None |
all_tasks() | 当前循环的未完成 Task | 受控诊断、任务盘点 | 不包含已完成任务 |

把这两个函数混用,最常见的误会是“我已经拿到当前 Task,所以它应该等于 all_tasks() 的唯一元素”。实际应用通常有多个并发任务;当前 Task 只是其中一个观察点,而 all_tasks() 是集合视角。
用任务名和协程对象确定“它是谁”
如果同时运行多个相同协程,默认任务名不够稳定,也不利于日志阅读。创建任务时显式指定 name,再通过 get_name() 读取,是最轻量的身份标记。需要进一步确认任务包装了哪一个协程,可以读取 get_coro(),但不要把协程对象的字符串表示当作业务请求 ID。
import asyncio
async def wait_for_item():
# 让任务保持挂起,便于观察任务身份;示例不代表实际运行结果。
await asyncio.sleep(0.2)
async def inspect_current_task():
# 当前函数运行在 Task 内,因此可以取得一个具体 Task。
task = asyncio.current_task()
if task is None:
# 兼容被同步入口或特殊调度环境调用的情况。
print("当前代码不在 asyncio Task 中")
return
# 创建任务时给出稳定名称,日志中比默认编号更容易检索。
worker = asyncio.create_task(wait_for_item(), name="inventory-worker")
print("当前任务:", task.get_name())
print("新任务:", worker.get_name())
print("协程对象:", worker.get_coro().__qualname__)
await worker
asyncio.run(inspect_current_task())
这里的关键不是打印对象本身,而是把身份信息拆开:get_name() 适合人读和日志聚合,get_coro() 适合确认封装的协程。Python 3.14 的任务创建 API 会把关键字参数传给 Task 或任务工厂,但业务标识仍建议用自己的 name 明确表达。
用 all_tasks 和 get_stack 找到挂起位置
任务“还没结束”不等于任务“卡死”。先用 all_tasks() 找到集合,再排除当前任务,最后读取每个任务的名称和栈信息,才能把观察结果变成有用的诊断记录。对于尚未完成的协程,get_stack() 返回它当前挂起的位置;已经成功完成或被取消的任务,栈列表可能为空。
import asyncio
def snapshot_tasks():
# 这个函数必须从正在运行的事件循环上下文调用。
current = asyncio.current_task()
tasks = asyncio.all_tasks()
for task in tasks:
# 诊断当前任务时跳过自己,避免把观察代码当成业务阻塞点。
if task is current:
continue
# 只读取轻量身份和挂起栈,不在这里调用 result()。
frames = task.get_stack(limit=1)
location = frames[0].f_code.co_name if frames else "无挂起栈"
print(task.get_name(), location, task.done())
async def main():
# 显式命名让集合观察结果能够对应到业务任务。
worker = asyncio.create_task(asyncio.sleep(1), name="billing-worker")
snapshot_tasks()
await worker
asyncio.run(main())
这里故意没有调用 task.result()。尚未完成的任务没有可读取结果,过早调用可能抛出 InvalidStateError;诊断阶段先观察 done()、名称和挂起栈,结果处理留给任务真正完成之后。

把定位代码放进可控的调试入口
不建议每个业务函数都调用 all_tasks()。它适合错误处理、开发环境诊断端点或明确开启的调试日志;生产环境应控制调用频率和输出内容,避免把任务对象、请求参数或敏感上下文直接写入日志。一个实用的判断顺序是:先确认是否在 Task 内,再取当前任务名;只有需要盘点并发状态时,才收集未完成任务集合。
Python 3.14 的官方变更说明还列出了 python -m asyncio ps PID 和 python -m asyncio pstree PID 两个进程级观察入口,前者展示任务表,后者展示异步调用树。它们适合进一步排查长时间运行的进程,但并不改变应用内 current_task() 与 all_tasks() 的语义。
常见问题
为什么 current_task() 返回 None?
它表示当前执行位置没有运行中的 asyncio Task。把调用移到协程内部,或在明确的事件循环上下文里调用;不要把 None 当成任务异常。
all_tasks() 会包含已经完成的任务吗?
不会。官方定义是返回当前循环中尚未完成的 Task。需要处理结果时,应保留创建任务时得到的 Task 引用,并在合适的时机等待或读取结果。
get_stack() 能返回完整调用链吗?
它返回任务的栈帧列表;对于挂起中的协程,官方文档特别说明通常只返回一个栈帧。要观察更完整的进程级任务关系,可以结合 Python 3.14 的 pstree 入口,但仍应把它当作诊断信息而不是业务状态。
Java MethodHandles.filterArguments 怎样按位置预处理方法参数
- 上一篇
- Java MethodHandles.filterArguments 怎样按位置预处理方法参数
- 下一篇
- Python warnings context manager 怎样临时调整警告过滤
-
- 文章 · python教程 | 31分钟前 | 标准库 · Python教程 · Python 类型注解 Python 3.14 annotationlib get_annotations ForwardRef 延迟注解
- Python 3.14 annotationlib.get_annotations 怎样读取延迟注解
- 423浏览 收藏
-
- 文章 · python教程 | 31分钟前 |
- Python 3.14 跨解释器 Queue.put 的阻塞与 QueueFull 处理方案
- 157浏览 收藏
-
- 文章 · python教程 | 17小时前 | xml · python · Python xml xml.etree.ElementTree canonicalize C14N
- Python xml.etree.ElementTree.canonicalize 怎样生成稳定的 XML 文本
- 151浏览 收藏
-
- 文章 · python教程 | 17小时前 | python · Python 弱引用 weakref getweakrefcount
- Python weakref.getweakrefcount 怎样查看对象关联的弱引用数量
- 248浏览 收藏
-
- 文章 · python教程 | 18小时前 | Python教程 · Python 检查点 随机状态 Random.getstate Random.setstate 模拟复现
- Python Random.getstate 怎样在模拟中途保存并恢复随机序列
- 149浏览 收藏
-
- 文章 · python教程 | 18小时前 | 并发控制 · Python教程 · asyncio · Python 协程同步 并发任务 asyncio.Barrier 阶段闸门 BrokenBarrierError
- Python asyncio.Barrier 怎样让多个协程在阶段边界同时放行
- 377浏览 收藏
-
- 文章 · python教程 | 18小时前 | python · Python SQLite sqlite3 SQL脚本 Connection iterdump
- Python sqlite3.Connection.iterdump 怎样生成可恢复的 SQL 脚本
- 342浏览 收藏
-
- 文章 · python教程 | 18小时前 | python · SQLite · Python SQLite sqlite3 Connection total_changes
- Python sqlite3.Connection.total_changes 怎样统计连接累计修改行数
- 422浏览 收藏
-
- 文章 · python教程 | 18小时前 | python · SQLite · Python order by sqlite3 COLLATE Connection create_collation
- Python sqlite3 自定义排序规则如何参与 ORDER BY
- 215浏览 收藏
-
- 文章 · python教程 | 18小时前 | JSON · python · Python JSON JSONEncoder iterencode JSON文本
- Python json.JSONEncoder.iterencode 怎样分段生成 JSON 文本
- 211浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1142次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1128次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1304次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1243次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1094次使用
-
- go-spew调试利器详解
- 2023-01-07 282浏览
-
- Goland 断点调试Debug的操作
- 2022-12-29 271浏览
-
- go格式“占位符”输入输出 类似python的input
- 2023-01-19 346浏览
-
- Golang如何调用Python代码详解
- 2023-01-07 235浏览
-
- golang调试bug及性能监控方式实践总结
- 2023-05-13 278浏览

