报错排查
Missing nodes / 缺失节点怎么修
修复 ComfyUI missing nodes 红色缺失节点问题,先用 Manager 自动安装,再根据节点名确认插件仓库、依赖和模型文件是否完整。
一句话结论
Missing nodes 先用 Manager 自动安装缺失节点;装完一定要重启 ComfyUI。如果重启后仍缺,再按节点名查插件仓库。


这张分流图只用于判断先修插件还是先换模型;遇到具体节点名称时,仍要以 Manager 的 missing nodes 列表为准。
上图用真实 ComfyUI 页面做底图,标出导入工作流后遇到红色缺失节点时的处理顺序:先修节点,再重启,再重新导入。
先分清缺节点和缺模型
- 缺节点:工作流里某个插件没装,节点会是红的。
- 缺模型:节点在,但下拉框里找不到模型文件。
这两种问题都能让工作流跑不起来,但解决入口完全不同。先别混着查。
Missing nodes 和模型缺失不是一回事
Missing nodes 是缺插件或节点包。模型缺失是文件名找不到。两者都会让工作流跑不起来,但排查入口不同。
自动修复流程
- 安装并打开 ComfyUI Manager。
- 导入有问题的工作流。
- 打开 Install Missing Custom Nodes。
- 安装识别出的节点包。
- 关闭 ComfyUI 并重启。
- 重新导入工作流。
安装后必须检查的 3 件事
- 红色节点有没有真的消失。
- 控制台有没有新的 import failed。
- 节点名是否已经出现在搜索结果里。
如果只是点了安装按钮但没重启,很多节点不会真正加载出来。
自动识别失败怎么办
复制红色节点名,在搜索引擎、GitHub 或工作流原页面查。很多节点名不是仓库名,例如节点叫 “KSampler Advanced Provider”,仓库可能是另一套插件包。
装完仍然失败
看启动窗口,如果出现 No module named xxx,说明插件装了但 Python 依赖没装好。看 /guides/no-module-named/。
如果出现 import failed,看 /guides/custom-nodes-import-failed/。
验证是否成功
重新打开工作流后红色节点消失,控制台不再出现同一插件的 import failed,Queue 能继续执行。
如果自动识别失败
复制红色节点名去搜索,别只记“缺节点”这四个字。很多节点名字和仓库名不一样,必须对着工作流作者的说明找。
下一步推荐
- 下载别人工作流后红色节点:
/guides/red-missing-nodes-after-import/ - Manager 使用:
/guides/manager-usage/ - 插件 import failed:
/guides/custom-nodes-import-failed/