ComfyUI 缺失节点：修复红色工作流节点和节点包

如果你搜索的是 ComfyUI missing nodes、missing node packs、node has no class_type 或红色工作流节点，本页面针对的是导入后出现红色、不可用或无法解析的工作流节点。首先判断哪一层出现了问题：共享工作流可能需要自定义节点包、更新版的内置节点、可用的前端包，或者放置在正确文件夹中的模型文件。

当主要可见错误并非缺失节点时，请使用更具针对性的指南：

• 前端入口点消息：使用 ComfyUI clean library entry point 指南。
• ControlNetApplyAdvanced class_type：使用 ControlNetApplyAdvanced class_type 指南。
• failed to save workflow draft：使用 保存工作流草稿失败。

本缺失节点修复路径适用于常见情况：工作流存储了节点类型名称，但实际节点代码未安装或未能加载。

Wonderful Launcher 在截至 2026 年 6 月 29 日的 30 天遥测数据中，将缺失工作流资产列为真实的重复模式：27 次安装中检测到缺失模型，19 次安装中检测到缺失节点，21 次安装中检测到缺失节点克隆结果，17 次安装中检测到依赖项安装结果。这通常意味着工作流修复分为多个阶段：安装节点、加载插件、安装其依赖项，然后放置模型文件。

"缺失节点"通常意味着什么

实际上，缺失节点通常属于以下几种情况之一：

外观表现

当你加载包含缺失节点的工作流时，ComfyUI 会显示：

When loading the graph, the following node types were not found:
  - KSamplerAdvanced (Custom)
  - ControlNetApplyAdvanced
  - IPAdapterApply
  - CLIPTextEncodeSDXL

在工作流画布中，缺失节点显示为红色矩形，并标注节点类型名称。

如果是前端入口点消息

在安装随机 Python 包之前，将前端入口点的措辞视为工作流/前端兼容性线索。如果屏幕上的主要错误是这种情况，请使用专用的 ComfyUI clean library entry point 缺失指南。本页面专注于更广泛的缺失节点工作流路径。

按以下顺序处理：

1. 如果工作流来自更新版的 ComfyUI 设置，则同时更新 ComfyUI 及其前端包。
2. 尝试使用最简单的本地 URL 打开工作流，例如 http://127.0.0.1:8188，而非远程/代理页面。
3. 检查正常的内置节点是否仍能加载。如果不能，则问题范围超出了单个缺失的自定义节点。
4. 工作流打开后查找红色自定义节点。如果红色节点仍然存在，继续进行缺失节点修复。
5. 不要 pip install clean-library-entry-point 或类似的猜测名称。 该短语不是包名。

如果同一安装还显示前端版本警告，请使用 comfyui-frontend-package 未安装或已过时。如果可见问题是浏览器保存失败，请使用 保存工作流草稿失败。

如果缺失节点是 ControlNetApplyAdvanced

ControlNetApplyAdvanced 被 ComfyUI 记录为内置 ControlNet 节点。如果工作流报告 ControlNetApplyAdvanced class_type，不要先运行 pip install ControlNetApplyAdvanced；该包名不是修复路径。

如果该确切短语是主要错误，请使用专用的 ComfyUI ControlNetApplyAdvanced class_type 指南。本页面用于更广泛的缺失节点排查。

按以下顺序处理：

1. 如果工作流来自更新版设置，则更新 ComfyUI 本身。
2. 如果消息说 node id has no class_type，检查工作流 JSON 是否有效。
3. 如果节点存在但在排队时失败，验证 ControlNet 模型输入。
4. 仅在工作流实际使用预处理器节点时才安装 ControlNet 预处理器，例如 Canny、Depth、OpenPose 或类似的辅助节点。

这是同一缺失节点原则的更具体形式：首先判断节点是内置的、自定义的、在工作流 JSON 中已损坏，还是在执行时失败。

原因

• 工作流来自其他用户：他们安装了你没有的自定义节点
• 未安装自定义节点：工作流使用的节点包需要单独安装
• 自定义节点已安装但未加载：节点包存在于 custom_nodes/ 中，但导入失败
• 不同的 ComfyUI 版本：某些内置节点是在更新版本中添加的
• 节点已重命名或删除：自定义节点包更新后重命名或删除了某个节点类型

避免无效安装的最快方法

在安装任何内容之前，先快速问三个问题：

1. 这是真正的自定义节点还是更新版本的内置节点？
2. 工作流是否来自安装了额外节点包的其他机器？
3. 启动日志是否显示你已安装的某个包的导入失败？

这项检查可以避免大量盲目的 pip install 和重复的插件安装。

逐步修复

第 1 步：识别缺失节点

加载工作流时的弹窗列出了所有缺失的节点类型。将它们记下来或截图保存。

如果你关闭了弹窗，还可以：

• 在工作流画布中查找红色方框
• 检查 ComfyUI 启动日志中的 IMPORT FAILED 消息
• 打开工作流 JSON 文件并搜索节点类型名称

第 2 步：使用 ComfyUI Manager 查找并安装

如果你已安装 ComfyUI Manager：

1. 点击 ComfyUI 菜单中的 Manager
2. 点击 Install Missing Custom Nodes
3. ComfyUI Manager 将尝试将缺失的节点类型匹配到已知的自定义节点包
4. 安装建议的包
5. 重启 ComfyUI

第 2.5 步：如果"Install Missing Custom Nodes"失败

缺失节点安装失败与工作流已修复并不相同。重试之前，先确定安装在哪里停止了。

导入工作流后的修复阶段

不要将第一次改善视为最终修复。共享工作流可能在多个阶段失败：

这种分阶段视图很有用，因为它防止了一种常见的错误收尾："红色节点消失了"并不意味着工作流已准备好。将工作流排队运行一次，然后按照最新的错误处理。

如果重试给出相同的克隆或权限错误，停止并保留当前日志。重复相同的安装命令通常只会增加噪音而不改变阻碍因素。

第 3 步：如果 Manager 找不到则手动安装

某些自定义节点不在 ComfyUI Manager 的注册表中。你需要手动查找它们：

1. 在 GitHub 上搜索节点类型名称（例如 "IPAdapterApply" comfyui custom node）
2. 将仓库克隆到你的 custom_nodes/ 文件夹中：

cd ComfyUI\custom_nodes
git clone https://github.com/author/ComfyUI-NodePack.git

3. 安装节点的依赖项：

.\python_embeded\python.exe -s -m pip install -r ComfyUI\custom_nodes\ComfyUI-NodePack\requirements.txt

4. 重启 ComfyUI

第 4 步：如果节点已安装但仍显示红色

如果自定义节点文件夹存在但节点仍显示红色或缺失：

• 检查启动日志中的 IMPORT FAILED ——节点包可能存在依赖错误
• 节点包可能需要更新：cd ComfyUI\custom_nodes\<pack> && git pull
• 节点所需的 Python 包可能缺失——查看回溯信息了解详情

第 4.5 步：区分"缺失包"和"损坏包"

这个区别很重要：

• 缺失包：文件夹或插件从未安装
• 损坏包：文件夹存在，但启动时导入失败

如果包存在但节点仍显示红色，请快速跳转到：

• ComfyUI 插件导入失败
• 修复 ComfyUI 中的 No module named 错误
• ComfyUI 依赖冲突

第 5 步：验证

安装所有缺失节点并重启后，再次加载工作流。所有节点应显示正常颜色并完全正常运行。

验证应包括正在运行的后端，而不仅仅是磁盘上的文件夹：

• 插件文件夹存在于 custom_nodes/ 下
• ComfyUI 在安装后已重启
• 启动日志未显示该插件的 IMPORT FAILED
• 工作流中不再出现红色节点类型
• 任何剩余的错误与模型、输入或执行有关，而非缺失节点类

内置节点与自定义节点

一些看起来像自定义节点的节点实际上是 ComfyUI 的内置节点，但是在特定版本中添加的。如果缺失节点的名称是通用名称（例如 KSampler 或 VAEDecode），你可能需要更新 ComfyUI 本身：

cd ComfyUI
git pull

Wonderful Launcher 是更安全选择的情况

工作流缺失节点修复在以下情况下会变得复杂：

• 同时缺失多个包
• 一次安装揭示多个依赖冲突
• 你不确定节点是内置的还是第三方的
• 工作流很重要，你不想破坏正常运行的环境

这正是引导式缺失节点检测和托管插件修复通常比手动试错节省更多时间的地方。

不要盲目运行 pip install 的情况

• 不要同时安装每个自定义节点包的依赖项——它们可能会冲突
• 运行 requirements.txt 之前先阅读它，检查是否有 torch 降级
• 如果节点包非常旧或无人维护，考虑寻找替代方案
• 某些节点包有复杂的构建要求（C++ 编译、CUDA 扩展），可能无法在所有系统上运行
• 不要将 Git 克隆失败或被拒绝的安装视为 Python 依赖问题

Wonderful Launcher 如何提供帮助

Wonderful Launcher 可以在你导入工作流时帮助检测缺失节点，并引导你安全地安装所需的自定义节点包。它还有助于保持修复状态清晰：缺失节点、安装被阻止、插件导入失败或模型资产仍待处理。

下载 Wonderful Launcher ——免费使用，让工作流共享更轻松。

相关错误

• ComfyUI 工作流红色节点
• ComfyUI 前端入口点指南
• ComfyUI ControlNetApplyAdvanced class_type 修复
• 导入工作流后节点显示红色
• ComfyUI 插件导入失败
• 安装自定义节点
• 常用 ComfyUI 自定义节点包
• ComfyUI 获取自定义节点列表失败
• ComfyUI 中 Safetensors 文件的放置位置
• ComfyUI Manager

来源参考

• ComfyUI GitHub
• ComfyUI ControlNetApplyAdvanced 内置节点文档
• ComfyUI 官方自定义节点安装指南
• ComfyUI Manager 官方自定义节点管理指南
• ComfyUI Manager GitHub