Python / 系统课时
TaskGroup 怎样统一管理任务
TaskGroup 怎样统一管理任务
当一组异步任务必须一起启动、一起收尾,并在任一任务失败时及时停止其余工作,asyncio.TaskGroup 比手动保存任务列表更容易维护。它把任务的创建、等待、取消和异常汇总限制在同一个 async with 作用域内。
学习目标
- 使用
TaskGroup创建并等待一组相关任务 - 理解子任务失败后其余任务的取消与异常传播
- 判断什么时候应把并发工作放进同一个结构化并发边界
TaskGroup 管的是任务生命周期
TaskGroup 从 Python 3.11 开始提供。进入 async with asyncio.TaskGroup() 后,通过 create_task() 创建的任务都属于这个组;离开作用域前,任务组会等待这些任务结束,因此调用方不需要再逐个 await。
这种结构的关键不是“少写几个 await”,而是把资源边界写进代码:调用方只要还在 TaskGroup 作用域内,就知道组内任务还可能运行;一旦正常离开作用域,就可以认为这些子任务已经全部收尾。

统一失败路径如何工作
如果组内某个任务首次抛出 CancelledError 之外的异常,TaskGroup 会取消仍未完成的兄弟任务,并等待它们完成清理。随后,相关异常会在退出 async with 时以 ExceptionGroup 或 BaseExceptionGroup 的形式抛出。
这意味着失败不会悄悄留下仍在后台运行的同组任务。对于网络服务中的“一次请求拆成多个并行子操作”,这种行为尤其重要:任一关键子操作失败后,通常不希望其他子操作继续占用连接、锁或配额。
用一个失败任务观察取消
下面的示例启动三个任务。B 在 0.2 秒后失败,C 原本需要 1 秒才能完成,因此会被任务组取消;A 已经完成,不受影响。
import asyncio
async def worker(name: str, delay: float, fail: bool = False) -> str:
try:
await asyncio.sleep(delay)
if fail:
raise RuntimeError(f"{name} failed")
print(f"{name}: done")
return name
except asyncio.CancelledError:
# 被兄弟任务的失败连带取消时,保留取消语义并继续抛出。
print(f"{name}: cancelled")
raise
async def main() -> None:
try:
async with asyncio.TaskGroup() as group:
group.create_task(worker("A", 0.1))
group.create_task(worker("B", 0.2, fail=True))
group.create_task(worker("C", 1.0))
except* RuntimeError as errors:
# except* 用于处理异常组中匹配到的 RuntimeError。
for error in errors.exceptions:
print(f"caught: {error}")
asyncio.run(main())预期输出
A: done
C: cancelled
caught: B failed实际调度时刻可能略有差异,但在这些固定延迟下,关键关系不变:A 先完成,B 的异常触发 C 的取消,异常在任务组完成收尾后统一交给外层处理。
结果与任务句柄
TaskGroup 不像 asyncio.gather() 那样直接返回一个结果列表。需要结果时,可以保留 create_task() 返回的 Task 对象,并在任务组正常退出后读取 task.result()。这样既保留结构化生命周期,又能按名称或业务含义管理结果。
如果任务组可能失败,不要在异常处理完成前随意读取每个任务的结果:任务可能成功、失败或已取消。更稳妥的做法是先决定整组失败时业务是否允许使用部分结果,再设计相应的数据结构。
什么时候优先使用 TaskGroup
当这些任务属于同一业务动作、共享同一失败边界,或要求父协程结束前必须确认所有子任务已收尾时,优先使用 TaskGroup。它适合并行请求多个后端、同时处理一批连接、为单个请求启动多个协作任务等场景。
如果任务彼此独立,即使调用方结束后仍应继续运行,那么它们本质上就不属于同一个结构化并发边界,应单独设计生命周期、错误记录和关闭策略,而不是为了方便统一塞进一个 TaskGroup。