asyncio.gather不支持任务依赖，必须通过分层await或create_task显式建模依赖关系；错误使用会导致TypeError、None结果或逻辑错乱。
asyncio.gather 本身不支持依赖关系，强行用会出错
asyncio.gather 只是并发触发多个 awaitable，它不管谁等谁、谁依赖谁。如果你写成 await asyncio.gather(task_a(), task_b(), task_c())，而 task_c() 实际上需要 task_b() 的返回值，那运行时大概率抛 TypeError: object is not awaitable 或者逻辑错乱——因为 task_c() 被提前调用了，没拿到输入。
常见错误现象：任务看似“并发”，但结果为空、None、KeyError，或者报 RuntimeError: Task got bad yield（尤其在手动 create_task 后又误传协程对象）。
- 依赖必须显式建模：靠调用顺序或
await链，不是靠gather参数顺序 -
gather的参数是“同时启动”的协程对象，不是函数名；传task_c（没加括号）会直接报错，传task_c()则立即执行（可能缺依赖） - 如果真想“并发 + 有依赖”，得把依赖关系拆成子任务组，再分层
gather
用嵌套 gather + await 分层表达依赖树
比如 A 和 B 可并行，C 依赖 A 和 B 的结果，D 依赖 C —— 这种结构不能扁平塞进一层 gather，但可以两层组合：
async def main():
# 第一层：并发跑 A 和 B
a_res, b_res = await asyncio.gather(task_a(), task_b())
<pre class="brush:python;toolbar:false;"># 第二层：C 等待 A+B，然后 D 等待 C（也可把 C 和其它同级依赖一起 gather）
c_res = await task_c(a_res, b_res)
d_res = await task_d(c_res)
return d_res
更紧凑的写法（适合 C 有多个同级依赖且 D 不依赖其它）：
async def main():
a_res, b_res = await asyncio.gather(task_a(), task_b())
c_res = await task_c(a_res, b_res)
# 如果还有 e_res = await task_e() 且和 c_res 无关，可放这里并发：
# e_res, f_res = await asyncio.gather(task_e(), task_f())
d_res = await task_d(c_res)
- 每层
gather对应一个“无依赖并行组”，组内任务之间无数据依赖 - 组与组之间用
await表达串行依赖，这是唯一可靠的方式 - 避免在
gather里写await task_x()：那会阻塞整个组，失去并发意义
依赖动态生成时，用 asyncio.create_task + 显式 await 更安全
当依赖关系不是写死的（比如根据配置加载不同服务、按响应结果决定下一步），硬套 gather 容易漏 await 或重复 await。这时候推荐用 asyncio.create_task 手动管理生命周期：
async def dynamic_flow(data):
# 并发启动基础任务
task_a = asyncio.create_task(task_a())
task_b = asyncio.create_task(task_b())
<pre class="brush:python;toolbar:false;"># 等它们完成
a_res, b_res = await task_a, await task_b
# 根据结果决定是否启动 C
if a_res.get("flag"):
task_c = asyncio.create_task(task_c(a_res, b_res))
c_res = await task_c
return await task_d(c_res)
else:
return await task_f(b_res)
-
create_task返回Task对象，可暂存、可条件 await、可取消（task.cancel()） - 比直接
await task_c()更灵活：你可以在 await 前做判断、日志、超时控制 - 注意别忘了
await，否则任务不会真正执行；也别重复await同一个 task（会报InvalidStateError）
别忽略异常传播和 cancel 语义
asyncio.gather 默认遇到第一个异常就停，但实际依赖场景中，你可能希望：A 失败时跳过 C、B 成功时继续跑 D。这时默认行为反而有害。
- 加
return_exceptions=True让gather把异常当普通返回值（类型是Exception实例），后续自己处理 - 用
asyncio.wait替代gather可获得更细粒度控制（比如只等 first_completed、设置 timeout） - 如果某任务被 cancel，它的依赖任务不会自动 cancel —— 必须手动检查
task.done()或用asyncio.shield保护关键路径 - 最易忽略的一点：依赖链中任一环节没做异常处理，上层
await就会直接崩，整条链中断；建议每个叶节点任务都包try/except
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
