Session deadlocks (never completes, no error) when an `If` node’s branch input comes from a chain containing an `Iterate` node

问题场景

用户在 InvokeAI 的 workflow editor 中构建了“条件使用一批结果”的工作流：src → iterate → body → collect ──true_input──→ if，同时 cond ──condition──→ if。当会话运行时，next() 返回 None，is_complete() 为 False，has_error() 为 False，队列项永久卡住，没有任何节点被继续执行。

报错原文

Session deadlocks (never completes, no error) when an `If` node's branch input comes from a chain containing an `Iterate` node

is_complete: False
has_error:  False
next():     None
  src: ['pending']
  iter: never prepared
  body: never prepared
  collect: never prepared
  cond: ['executed']
  if_node: never prepared

原因分析

根因在 _IfBranchScheduler.get_branch_exclusive_sources() 与 _ExecutionMaterializer.prepare() 的交互逻辑中：

• _IfBranchScheduler 会把 If 节点的每个分支输入展开为所有上游祖先节点，并将这些节点标记为“在 If 解析前暂缓执行”（is_deferred_by_unresolved_if）。在本例中，这个集合为 {collect, body, iter, src}。
• 没有 Iterate 时，整条链可以在一次 prepare() 中物化，If 解析后暂缓状态解除，流程正常。
• 但链中包含 Iterate 时，prepare() 会拒绝物化迭代器，直到它的所有输入源都已执行完毕。由于上游节点都被标记为暂缓，形成了循环等待，导致死锁。

环境排查

• 确认 InvokeAI 版本是否包含该修复（Issue 于 2026-08-24 关闭，但未列出具体修复版本号）。
• 检查工作流中是否存在 If 节点的 true_input/false_input 来自包含 Iterate 的链路。
• 可尝试用 PYTHONPATH=. 从仓库根目录运行 Issue 中提供的复现脚本来验证环境。

解决步骤

1. 升级 InvokeAI 到包含此修复的最新版本，或拉取 main 分支的最新代码重新构建。
2. 如果无法立即升级，可优先尝试调整工作流结构：将 Iterate 的结果先通过 Collect 收集后，再额外用一个中间节点（如 Pass 或自定义节点）绕过 If 分支输入的直接依赖链。
3. 如果问题仍然存在，请确认工作流中 If 节点的 condition 输入是否已提前执行完毕（如 Issue 示例中的 cond 节点状态为 executed）。
4. 检查是否存在其他包含 Iterate 且需要被 If 分支引用的场景，尝试将 Iterate 移出分支输入链。

验证方法

重新运行问题中的复现脚本或相同结构的工作流，确认 next() 返回非 None 值，is_complete() 最终为 True，并且 src → iter → body → collect → if_node 所有节点均被执行。if_node 应正确选择收集到的列表。

参考来源

invoke-ai/InvokeAI #9484

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。