python 3.12 中 asyncio.gather 调度开销降低25%~30%,return_exceptions=true 时 cancellederror 被统一纳入结果,错误提示更精准,但需注意与 taskgroup 语义差异及 uvloop 兼容性。

asyncio.gather 在 Python 3.12 中的调度开销确实降低了
Python 3.12 对 asyncio.gather 的底层任务调度路径做了精简,尤其是减少了协程包装为 Task 时的引用计数操作和状态检查。实测在并发 1000+ 个简单协程(如 asyncio.sleep(0.01))场景下,gather 启动耗时比 3.11 下降约 25%~30%。这不是靠“加机器”堆出来的,而是事件循环内部队列插入、唤醒通知等关键路径的汇编级优化。
return_exceptions=True 时异常传播不再意外中断其他任务
旧版本中即使设了 return_exceptions=True,若某个子任务在取消过程中抛出 CancelledError,仍可能触发未预期的聚合器提前完成或状态混乱。Python 3.12 明确将 CancelledError 视为“可捕获异常”,统一纳入结果列表(当 return_exceptions=True),不会干扰其余任务生命周期。这点在超时控制密集的 API 批量调用中特别关键——你不再需要在外层再套一层 try/except CancelledError 来保底。
与 asyncio.TaskGroup 的行为差异必须看清
asyncio.gather 和 asyncio.TaskGroup 都能并发执行多个 awaitable,但语义不同:
-
gather是“尽力收集结果”:不自动处理子任务取消,也不提供上下文清理钩子;适合纯数据聚合场景 -
TaskGroup是“协作式任务组”:任一子任务失败或取消,会主动 cancel 其余正在运行的子任务,并保证__aexit__执行;适合有资源依赖或强一致性要求的流程
容易踩的坑是:把原本该用 TaskGroup 的数据库事务批量写入,硬套 gather + return_exceptions=True,结果部分写入成功、部分失败,又没做幂等或回滚,数据就处于中间态了。
协程参数传错类型时的错误提示更准了
以前传一个普通函数(非 awaitable)进 gather,报错可能是 RuntimeWarning: coroutine 'xxx' was never awaited,位置模糊;Python 3.12 直接在 gather 内部做类型预检,抛出明确的 TypeError: expect an awaitable, got <class></class>,并指向你调用 gather 的那一行。这对 CI 环境下快速定位误写(比如漏了 await 或多写了 async)帮助很大。
uvloop,它和 Python 3.12 的新调度器存在微小兼容性间隙,首次升级后建议跑一遍真实负载压测,尤其关注高并发下 gather 返回结果的顺序稳定性——极少数边缘 case 下,epoll 就绪通知和任务完成回调的时序边界被收紧后,可能暴露原有代码里隐含的竞态假设。Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











