about:“PreviewBridge”

问题场景

用户在 ComfyUI 中运行包含 PreviewBridge 节点（Node Type: PreviewBridge）的工作流时，节点需要读取 clipspace 目录下形如 clipspace/clipspace-mask-*.png 的输入文件，处理过程中直接报错中断。该问题在 Issue 讨论中被多名用户复现，涉及普通 ComfyUI 安装与 StabilityMatrix 部署两种路径，Node ID 也不固定（如 48、179）。

报错原文

!!! Exception during processing !!! 'clipspace/clipspace-mask-452864.7999999989.png'
Traceback (most recent call last):
  File "E:\ComfyUI\ComfyUI\execution.py", line 349, in execute
    output_data, output_ui, has_subgraph = get_output_data(obj, input_data_all, execution_block_cb, pre_execute_cb, pre_execute_cb)
  File "E:\ComfyUI\ComfyUI\custom_nodes\comfyui-impact-pack\modules\impact\bridge_nodes.py", line 89, in doit
    pixels, mask, path_item = PreviewBridge.load_image(image)
  File "E:\ComfyUI\ComfyUI\custom_nodes\comfyui-impact-pack\modules\impact\bridge_nodes.py", line 51, in load_image
    image_path, ui_item = core.preview_bridge_image_id_map[pb_id]
                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^
KeyError: 'clipspace/clipspace-mask-452864.7999999989.png'

也有报告在异常信息中带有后缀，如 ‘clipspace/clipspace-mask-2864994.200000001.png [input]’。

原因分析

从堆栈看，PreviewBridge.load_image 在第 51 行用 pb_id 去查 core.preview_bridge_image_id_map，但该映射中没有这个 clipspace 文件对应的条目，于是抛出 KeyError。可能原因包括：Impact Pack 版本与当前 ComfyUI 的 clipspace/预览桥接机制不匹配（已有一条 git pull 后恢复的用户反馈）；某些第三方自定义节点可能干扰该映射的注册或清理，Issue 中曾点名 Efficiency Nodes，但多名用户移除后问题仍在，因此只能视为可能的诱因之一而非确定根因。

环境排查

• 确认 ComfyUI-Impact-Pack 的当前版本/提交，并检查是否落后于上游。
• 确认 ComfyUI 本体版本，判断是否与 Impact Pack 的预览桥接实现兼容。
• 确认是否为 StabilityMatrix 等便携部署，避免更新到错误目录。
• 确认是否安装 Efficiency Nodes 等可能影响预览/映射的自定义节点。
• 确认触发报错的工作流中 PreviewBridge 的输入是否指向已被清理或重新生成的 clipspace 临时图片。
• Issue 未给出 Python、CUDA、PyTorch、显卡版本要求，此处不做版本假设。

解决步骤

1. 进入 ComfyUI-Impact-Pack 目录执行 git pull，更新到最新版本，然后完整重启 ComfyUI，再重新加载工作流运行。这是 Issue 中已验证有效的操作。
2. 若更新后仍报错，可优先尝试临时移除 Efficiency Nodes 自定义节点并重启 ComfyUI，检查是否恢复。注意多位用户反馈此方法无效，因此只作为排除干扰的试探步骤。
3. 若仍未解决，检查工作流中的 PreviewBridge 节点：删除旧节点、重新添加，并重新连接输入，避免继续使用可能已失效的 clipspace 预览引用。
4. 在更新或移除节点前备份 custom_nodes 目录和当前提交记录，便于回滚。

验证方法

重启 ComfyUI 后重新运行原先触发报错的工作流，确认执行日志中不再出现 KeyError: PreviewBridge 的预览桥接报错，PreviewBridge 节点能正常输出图像与遮罩，且工作流可执行到后续节点完成。

参考来源

ltdrdata/ComfyUI-Impact-Pack #1004

AI 工具推荐

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

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

了解 GamsGo AI

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