是，TaskGroup 仅传播首个未处理异常，其余静默丢弃；需用 except ExceptionGroup 捕获并遍历 eg.exceptions 分析全部异常，且 ExceptionGroup 是 BaseException 子类。
TaskGroup 会自动传播未处理异常吗
会，但只传播第一个被触发的异常，其余异常会被静默丢弃。这是 TaskGroup 的默认行为，不是 bug，而是设计取舍——它优先保证“至少一个失败即终止”，避免异常风暴掩盖主因。
常见错误现象：asyncio.exceptions.ExceptionGroup 没出现，反而只看到单个 ValueError，但日志里其实有多个任务同时抛了 TimeoutError 和 ConnectionRefusedError。
- 使用场景：并发调用多个下游服务，任一失败就应中止整个批次
- 关键参数：
async with asyncio.TaskGroup() as tg:—— 不要手动创建TaskGroup实例，必须用async with - 若需保留所有异常，得主动捕获并聚合，
TaskGroup本身不提供“收集全部异常”的开关
如何捕获并检查所有子任务异常
靠 except ExceptionGroup: 捕获，再用 exceptiongroup.split() 或遍历 eg.exceptions 分析。注意 Python 3.11 原生支持 ExceptionGroup，但部分第三方库（如早期版本的 httpx）可能仍抛普通异常，导致无法进入 ExceptionGroup 分支。
示例：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
try:
async with asyncio.TaskGroup() as tg:
tg.create_task(fetch_url("https://a.com"))
tg.create_task(fetch_url("https://b.com"))
tg.create_task(fetch_url("https://c.com"))
except ExceptionGroup as eg:
# eg.exceptions 是 tuple，含所有子异常
for i, exc in enumerate(eg.exceptions):
print(f"task {i}: {type(exc).__name__} - {exc}")
- 必须显式写
except ExceptionGroup:，不能只写except Exception:（后者捕不到ExceptionGroup） -
ExceptionGroup是BaseException子类，不是Exception子类，所以except BaseException:才能兜底 - 如果某个子任务抛的是
SystemExit或KeyboardInterrupt，TaskGroup会立即中止并原样抛出，不打包进ExceptionGroup
在 TaskGroup 中混用 cancel() 和异常传播的风险
手动调用 tg.cancel() 后，仍在运行的任务若再抛异常，该异常会被忽略——因为 TaskGroup 已处于“取消中”状态，不再收集新异常。这容易造成误判：你以为任务失败了，其实是被取消后又意外抛错，而错误信息丢了。
- 正确做法：取消操作应作为最后手段，优先靠业务逻辑控制任务生命周期
- 若必须取消，应在
async with块内完成，并确保所有create_task调用早于cancel() - 调试时可加
asyncio.current_task().get_coro()打印当前协程名，确认哪些任务真正在跑、哪些已被取消
与 asyncio.gather() 的异常行为差异
gather(return_exceptions=False)（默认）遇到首个异常就停止等待，但不会取消其他任务；而 TaskGroup 遇到首个异常会立即取消所有剩余任务。这意味着资源清理更及时，但也更激进。
- 性能影响：取消活跃任务有开销，尤其当任务已持有锁或打开文件句柄时，需确保
__aexit__或finally块能正确释放 - 兼容性注意：Python TaskGroup，回退方案不能只靠
gather，得配合asyncio.shield()+ 显式 cancel 逻辑 - 不要用
gather(return_exceptions=True)替代TaskGroup——它返回的是异常对象而非抛出，无法触发自动取消，且异常类型丢失上下文
真正难处理的不是“怎么捕获异常”，而是判断哪些异常该合并上报、哪些该单独告警，以及取消后残留状态是否干净。这些没法靠语法糖解决，得结合具体 IO 类型和超时策略来设计。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
