报错排查

Missing nodes / 缺失节点怎么修

修复 ComfyUI missing nodes 红色缺失节点问题,先用 Manager 自动安装,再根据节点名确认插件仓库、依赖和模型文件是否完整。

有效 适用版本:2026-05 难度:新手 预计:10 分钟 更新:2026-05-15 复查:2026-06-15

一句话结论

Missing nodes 先用 Manager 自动安装缺失节点;装完一定要重启 ComfyUI。如果重启后仍缺,再按节点名查插件仓库。

ComfyUI Missing nodes 修复入口标注

红色缺失节点与模型缺失的分流检查

这张分流图只用于判断先修插件还是先换模型;遇到具体节点名称时,仍要以 Manager 的 missing nodes 列表为准。

上图用真实 ComfyUI 页面做底图,标出导入工作流后遇到红色缺失节点时的处理顺序:先修节点,再重启,再重新导入。

先分清缺节点和缺模型

  • 缺节点:工作流里某个插件没装,节点会是红的。
  • 缺模型:节点在,但下拉框里找不到模型文件。

这两种问题都能让工作流跑不起来,但解决入口完全不同。先别混着查。

Missing nodes 和模型缺失不是一回事

Missing nodes 是缺插件或节点包。模型缺失是文件名找不到。两者都会让工作流跑不起来,但排查入口不同。

自动修复流程

  1. 安装并打开 ComfyUI Manager。
  2. 导入有问题的工作流。
  3. 打开 Install Missing Custom Nodes。
  4. 安装识别出的节点包。
  5. 关闭 ComfyUI 并重启。
  6. 重新导入工作流。

安装后必须检查的 3 件事

  1. 红色节点有没有真的消失。
  2. 控制台有没有新的 import failed。
  3. 节点名是否已经出现在搜索结果里。

如果只是点了安装按钮但没重启,很多节点不会真正加载出来。

自动识别失败怎么办

复制红色节点名,在搜索引擎、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/