
Preview Bridge: Mask editor broken
快速结论:该错误在 ComfyUI Impact Pack 的 Preview Bridge 节点(图像/潜空间)中使用”Mask editor | Image Canvas”时触发,优先排查 ComfyUI 前端版本,升级至 v1.37.1 或更高版本可解决。
问题场景
用户在 ComfyUI 中使用 Impact Pack 的 Preview Bridge 节点编辑遮罩时,点击”Mask editor | Image Canvas”无响应或无法打开编辑器;而标准”Load Image”节点的遮罩编辑器正常工作。该问题在 ComfyUI 0.3.76、ComfyUI_frontend v1.33.10、Impact Pack 8.28.0 环境下被首次报告。
报错原文
The "mask editor | Image Canvas" is not working for both image and latent Preview Bridge.
原因分析
可能原因:
- ComfyUI 前端版本过旧导致遮罩编辑器与 Preview Bridge 节点的交互接口不兼容(问题确认存在于 frontend v1.33.x 系列,回退到 v1.32.9 可临时工作)。
- 前端”Nodes v2″更新(即使未启用)可能破坏了 Legacy UI 中 Preview Bridge 的遮罩编辑功能。
- 遮罩编辑器尝试从临时地址加载图像时,ComfyUI 服务器无法找到对应资源,导致编辑器白屏或卡死。
环境排查
- ComfyUI 版本(建议 ≥ v0.10.0)
- ComfyUI_frontend 版本(需 ≥ v1.37.1)
- ComfyUI Impact Pack 版本(≥ 8.28.0)
- 检查 ComfyUI 启动脚本是否使用了
--front-end-version参数固定前端版本
解决步骤
- 升级 ComfyUI 至最新版本:至少升级到 v0.10.0(该版本默认使用前端 v1.36.14,经测试遮罩编辑器工作正常)。
- 强制使用最新前端版本(可优先尝试):在 ComfyUI 启动命令中添加
--front-end-version Comfy-Org/ComfyUI_frontend@latest,强制加载最新前端(≥ v1.37.1)。 - 临时降级方案(备选):回退 ComfyUI_frontend 至 v1.32.9 可恢复遮罩编辑器功能(不推荐长期使用)。
- 避免使用节点重命名变通:有用户尝试在
__init__.py中将PreviewBridge重命名为PreviewBridgeFIX,这仅部分绕过问题且不稳定,不推荐作为正式修复。
验证方法
在 Preview Bridge 节点上点击”Mask editor | Image Canvas”,确认遮罩编辑器面板正常弹出并可选择/编辑遮罩区域。切换至标准”Load Image”节点对比确认二者工作行为一致。
参考来源
ltdrdata/ComfyUI-Impact-Pack #1157
Comfy-Org/ComfyUI_frontend #7437(相关上游问题)



