知仓学习社知仓学习社
工作流加载后提示缺少节点 / 节点显示红色（Warning: Missing Node Types） / 全站资源搜索
搜索 更新 2026-10-02
报错 028 依赖缺失与自定义节点安装失败 有来源可查

工作流加载后提示缺少节点 / 节点显示红色（Warning: Missing Node Types）

报错原文（原样） 
Warning: Missing Node Types
When loading the graph, the following node types were not found:
CogVideoTextEncode
CogVideoSampler
DownloadAndLoadCogVideoModel
CogVideoDecode
检索关键词 Missing Node Types、node types were not found、Cannot find node、节点变红、缺少节点、Missing nodes
先看这一句 打开别人分享的工作流后，节点显示为红色（红色节点/红框），顶部弹出缺节点提示并列出节点名；点 Manager 的 Install Missing Custom Nodes 装完后重启，仍然显示缺失。
适用版本 全版本通用 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 节点仓库其实没装成功（下载/克隆失败），但界面只显示“缺节点”
  • 节点装了但依赖缺失，目录在启动时 IMPORT FAILED，于是其节点等同不存在
  • 装的是同名但不同实现的节点，节点类型名对不上

根因

  • 红色节点只是表象：真因要么是节点包缺失，要么是节点包存在但导入失败，两种情况在界面上的表现几乎一样
  • Manager 的“安装缺失节点”走的是节点列表匹配，若该节点不在 Manager 数据库里（或下载失败），装完后依然缺
  • 节点包的注册名与工作流里的类型名不一致（改名、分家、弃用）

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 先看启动日志，区分“没装”与“装了但导入失败”
    在日志里搜这个节点名与 `(IMPORT FAILED)` / `Cannot import`。若能看到该目录的导入失败记录，说明是依赖问题，按对应报错条目修；若日志里完全没有该目录，才是真的没装。
  2. 用 Manager 的“安装缺失节点”或手动 git clone
    界面右上角/管理器里执行 Install Missing Custom Nodes；若 Manager 里搜不到该节点，去节点作者仓库手动 clone 到 custom_nodes，然后**用 ComfyUI 解释器**跑它的 requirements.txt，最后完全重启。
    cd ComfyUI\custom_nodes
    git clone <节点仓库地址>
  3. 确认节点类型名是否对得上
    打开节点仓库 README 核对 NODE_CLASS_MAPPINGS 中的注册名与工作流提示的名字是否完全一致；名字不一致时说明该工作流用的是旧版/已弃用节点，需要找替代节点或按作者说明做节点替换。

验证是否修好

重启后重新打开工作流，红色节点全部恢复为正常节点，顶部不再弹 Missing Node Types；执行一次工作流能正常跑通。

补充说明

本条报错原文取自 CogVideoXWrapper 的真实案例（该案例同时暴露了 git clone exit code(128) 导致的安装失败）。不同工作流列出的节点名不同，以你自己提示框中的名称为准。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [77] （节点仓库 issue）　Failed import · Issue #76 · kijai/ComfyUI-CogVideoXWrapper　https://github.com/kijai/ComfyUI-CogVideoXWrapper/issues/76
  2. [78] （节点仓库 issue）　Missing nodes - Tried many ways including clone Github and run python 　https://github.com/bytedance/ComfyUI_InfiniteYou/issues/15
  3. [79] （官方文档）　使用 ComfyUI-Manager 进行自定义节点管理（旧版 UI）　https://docs.comfy.org/manager/legacy-ui

这条报错要用到的东西

按本条报错所属的类别（依赖缺失与自定义节点安装失败）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库按用途找节点仓库，附适配模型与下载量 板块

同一类别的其他条目

【023】报错 No module named 'insightface'（IPAdapter 人脸加载器 / ReActor 换脸节点不可用） 有来源 【024】一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes） 有来源 【025】报错 No module named 'cv2'（controlnet_aux / WanVideoWrapper 等节点导入失败） 有来源 【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state（缺 Visual C++ 运行库 / onnxruntime 版本不匹配） 有来源 【027】报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'（diffusers 与新版 huggingface_hub 不兼容） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库