快速结论:当 Control Bridge(ImpactControlBridge)节点被放进 subgraph(子图)后,运行到该节点会发生 KeyError,节点 ID 形如 22:21。优先排查的是 Impact Pack 在 subgraph 场景下能否定位到节点 ID。
适用环境:macOS(darwin),ComfyUI Desktop 版 0.11.1,Python 3.12.9,PyTorch 2.10.0,设备类型 mps。Issue 作者为先安装 ComfyUI、只装 Impact Pack 节点的全新环境。
最快修复方案:暂无确认的一步修复方案。Issue 中给出的做法是修改 Impact Pack 的两个文件:在 comfyui-impact-pack/js/common.js 中加入递归查找子图节点与递归设置模式的函数,并替换 bridgeContinue(event);同时在 modules/impact/logics.py 中替换 workflow_to_map 与 ImpactControlBridge 类的实现。
注意事项:上述修改属于用户自行补丁,由 Issue 作者在本地试验后给出,并非官方已发布修复;升级 Impact Pack 或 ComfyUI 后可能被覆盖,需要重新核对。Issue 中未给出固定版本号或分支,也未覆盖其他行为的完整验证。
问题场景
在 macOS 上的 ComfyUI Desktop(0.11.1)中运行 Impact Pack,使用最简单的链路:Load Image → Control Bridge → Invert Image → Preview Image。当 Control Bridge 位于主图时,工作流正常;只要把它放进 subgraph,无论是否搭配其他节点,执行时都会报错,界面只显示节点名 ImpactControlBridge 和节点 ID 22:21,并没有更明确的错误提示。
报错原文
Exception Type: KeyError
Exception Message: '22:21'
Node Type: ImpactControlBridge
Node ID: 22:21
File ".../custom_nodes/comfyui-impact-pack/modules/impact/logics.py", line 693, in doit
for link in workflow_nodes[unique_id]['outputs'][0]['links']:
~~~~~~~~~~~~~~^^^^^^^^^^^
原因分析
最可能的原因是 Impact Pack 读取工作流时,workflow_to_map 只会遍历顶层 workflow['nodes'],没有处理 workflow['definitions']['subgraphs'] 中的节点。因此当 Control Bridge 位于子图内时,它使用的带命名空间的节点 ID(如 22:21)在 workflow_nodes 映射中不存在,doit 访问 workflow_nodes[unique_id] 即抛出 KeyError。
前端 bridgeContinue 使用 nodes[event.detail.node_id] 按顶层节点表查找,同样可能无法定位子图内节点,属于同一类 ID 作用域问题。
环境排查
- 确认 ComfyUI 版本与安装方式(Issue 环境为桌面版 0.11.1)。
- 确认 Impact Pack 的具体版本号或提交,以便对照补丁内容。
- 确认 Python 版本(3.12.9)与 PyTorch 版本(2.10.0)。
- 确认运行设备为 mps;Issue 中未出现 CUDA 相关信息。
- 确认报错节点 ID 是否为带
:的子图内 ID(如22:21)。 - 确认工作流 JSON 中节点是否位于
definitions.subgraphs内。
解决步骤
- 先确保这个节点在顶层工作流中可正常执行,以确认 Impact Pack 基础功能可用。
- 打开
comfyui-impact-pack/js/common.js,在app.ui.dialog.show = dialog_show_wrapper;之后加入findNodeById(graph, id)和setDeepMode(node, mode)两个函数:前者先查graph._nodes_by_id,未命中时递归进入node.subgraph;后者递归设置子图内所有节点的 mode。 - 用新版本替换整个
async function bridgeContinue(event):改用findNodeById(app.graph, event.detail.node_id)定位节点,按mutes/actives/bypasses集合分别设置 mode 2/0/4;当bypassplus为真时调用setDeepMode,否则直接设置targetNode.mode,最后执行await app.queuePrompt(0, 1)。 - 可选:把其他函数中的
let node = nodes[event.detail.node_id];改为let node = findNodeById(app.graph, event.detail.node_id);,让这些函数也能命中子图内节点。 - 打开
comfyui-impact-pack/modules/impact/logics.py,将workflow_to_map替换为支持子图的版本:接收this_node_id和insideSubgraph参数;在子图模式下扫描workflow['definitions']['subgraphs']找到包含目标节点的子图,兼容字典格式(含id/origin_id等字段)和旧列表格式的链接,并收集子图内的 nodes 与 links。 - 将
class ImpactControlBridge替换为 Issue 中给出的实现(包含Stop/Mute/Bypass/BypassPlus行为,并在处理时借助更新后的映射与子图查找逻辑)。 - 重启 ComfyUI,重新加载包含 subgraph 的工作流进行测试。
验证方法
用 Issue 中的示例工作流(Load Image → Control Bridge → Invert Image → Preview Image),把 Control Bridge 放在 subgraph 内后执行:不再出现 KeyError: '22:21',Preview Image 能正常输出结果;再分别切换 Control Bridge 的 Active / Stop/Mute/Bypass 状态,确认下游节点的模式切换与停止行为符合预期。
参考来源
ltdrdata/ComfyUI-Impact-Pack #1189
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


