Python 3.11的任务组有什么优势_对比TaskGroup与gather的错误处理-Python教程-PHP中文网

TaskGroup 会自动取消其余任务，gather 默认不会；TaskGroup 用 async with 管理生命周期，抛出 ExceptionGroup 并需 except* 捕获，而 gather 无语法约束、异常不聚合、需手动处理返回值。

python 3.11的任务组有什么优势_对比taskgroup与gather的错误处理

TaskGroup 会自动取消其余任务，gather 默认不会

当某个子任务抛出异常时，asyncio.TaskGroup 立即触发协作式取消：所有仍在运行的任务收到 CancelledError，并尽快退出。这是结构化并发的强制保障，避免“孤儿任务”继续占用连接、内存或 CPU。

asyncio.gather() 默认行为相反：只要一个任务失败，它立刻把异常向上抛，但其他任务照常运行——哪怕你没做任何处理，它们也会在后台悄悄跑完或卡死。这容易导致资源泄漏、超时叠加、状态不一致。

用 gather(..., return_exceptions=True) 可以把异常转成返回值，但你要自己遍历结果、逐个判断是否为 Exception 实例
TaskGroup 不需要你手动检查；离开 async with 块时，所有异常（包括多个）会被打包进 ExceptionGroup 一次抛出
若想只捕获某类异常，直接用 except* ValueError:，不用写一堆 isinstance()

TaskGroup 必须用 async with，gather 没有语法约束

asyncio.TaskGroup 是上下文管理器，不是普通类。你不能写 tg = asyncio.TaskGroup()，也不能手动调用 __aenter__ 或 __aexit__——这些都不是公开 API，行为不可靠。

正确写法只有一种：async with asyncio.TaskGroup() as tg:。此时框架会确保：无论正常退出还是异常中断，所有已创建任务都会被等待、清理、异常聚合。

忘记 async with 直接 new 一个对象？Python 会报 RuntimeError: TaskGroup is not running
在 async with 块里用 tg.create_task() 启动任务，不是 asyncio.create_task()
任务中途可以动态增删，比如根据响应内容决定是否启动下一页请求，gather 完全不支持这种模式

ExceptionGroup 是 Python 3.11 的配套机制，不是可选附加

TaskGroup 抛出的异常类型是 ExceptionGroup，不是单个 ValueError 或 TimeoutError。如果你还用老式 except ValueError:，会完全捕获不到——它被包在 ExceptionGroup 里了。

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

必须用 except* 语法才能解包匹配：

try:
    async with asyncio.TaskGroup() as tg:
        tg.create_task(task_fail())
        tg.create_task(task_slow())
except* ValueError as eg:
    print("至少有一个 ValueError:", eg.exceptions)
except* TimeoutError:
    print("有超时任务")

except* 是 Python 3.11 新增语法，3.10 及更早版本不支持
ExceptionGroup 支持嵌套，比如子任务组再抛出 ExceptionGroup，外层仍能统一处理
如果没写任何 except*，异常会原样冒泡，但 traceback 会明确标出每个子异常来源（Python 3.11 的带注释 traceback 会高亮 ^ 和 ~）