知仓学习社知仓学习社
打开别人的工作流，节点全变红，提示节点缺少 class_type 属性 / 全站资源搜索
搜索 更新 2026-10-02
报错 100 热门自定义节点/工作流专有报错 有来源可查

打开别人的工作流，节点全变红，提示节点缺少 class_type 属性

报错原文（原样） 
Node 'ID #267:275' has no class_type. The workflow may be corrupted or a custom node is missing.
检索关键词 has no class_type、The workflow may be corrupted or a custom node is missing、Cannot execute because a node is missing the class_type property、Node ID、missing nodes、红色节点
先看这一句 从网盘/社区下载的工作流 JSON 拖进 ComfyUI 后，画布上一片红色节点，点队列运行直接报错，或者提示 Cannot execute because a node is missing the class_type property。
适用版本 全版本通用；0.3.x 之后前端提示语更友好（会直接列出缺失节点的展示名），但根因相同 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境

现象与触发场景

常见触发场景：

  • 下载 B 站/小红书/Civitai 工作流，作者用了自己装的第三方节点包
  • 升级或重装 ComfyUI 后老工作流打不开
  • 工作流 JSON 在传输中被截断或改坏

根因

  • 工作流 JSON 里保存的是节点类的 class_type 与节点 ID 映射，你本机没有安装提供该 class_type 的自定义节点，前端无法解析该节点，于是渲染成红色空节点或直接报 class_type 缺失
  • 工作流文件本身损坏（下载不全、被文本编辑器改写、被网盘转码），节点定义整段丢失
  • 节点包安装了但版本太老/太新，该 class_type 在当前版本中已改名或已废弃，同样表现为节点解析不出来

解决步骤

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

  1. 先用 Manager 的「Install Missing Custom Nodes」自动补齐
    打开右侧菜单里的 Manager → 点 Install Missing Custom Nodes，Manager 会扫描当前打开的工作流，列出所有缺失的节点包并给出安装按钮。装完必须完全重启 ComfyUI（关掉命令行窗口再启动），再按浏览器 Ctrl+F5 强刷一次页面，然后重新打开工作流。注意 Manager 只能装到它数据库里登记过的包，作者自改的私有节点装不到。
  2. 装完还红的，手工核对缺失节点属于哪个包并手动 git clone
    在红色节点上右键，或把鼠标悬停在红节点上，前端会显示它原本的 class_type 名称（例如 FaceDetailer、ADE_AnimateDiffLoaderGen1、IPAdapterUnifiedLoader）。拿这个名字去 GitHub / ComfyUI Manager 的节点搜索里反查属于哪个仓库，再进 ComfyUI 的 custom_nodes 目录手动克隆。这一步必须做，因为作者魔改过的节点包 Manager 装不到。
    cd ComfyUI\custom_nodes
    git clone https://github.com/<作者>/<仓库名>.git
  3. 补齐该包的 Python 依赖（便携版必须用内置 Python）
    克隆下来的节点包只是代码，它还依赖 requirements.txt 里的 Python 包。Windows 便携版自带的解释器是 ComfyUI 根目录下的 python_embeded\python.exe，绝不能用系统里另外装的 python/pip，否则装到了别的环境里，报错照旧。先进到该节点目录，再调用便携版解释器安装依赖文件。
    cd ComfyUI\custom_nodes\<刚克隆的仓库名>
    ..\..\python_embeded\python.exe -m pip install -r requirements.txt
  4. 若工作流 JSON 本身损坏，改用作者的原始分享链接重新下载
    如果 Manager 和手工安装都补齐了，仍然只有一个节点报错且名字是变形/乱码，说明 JSON 本身坏了。不要用微信/QQ 转发的文件、不要用记事本打开再另存，回到作者原始分享页（Civitai / Google Drive / 作者 GitHub）重新下载 PNG 或 JSON，PNG 里内嵌的工作流最容易在转存时被剥离。

验证是否修好

重新打开工作流后画布上不再有红色节点；点 Queue 能进入正常执行流程，命令行窗口不再出现 'Cannot execute because a node is missing the class_type property'。

补充说明

error_text 取自 Hugging Face 讨论页标题原文；另一个官方 issue 标题为 'Issue with workflow to mix human faces - Cannot execute because a node is missing the class_type property.: Node ID '#3''，两种提示语均真实存在，已一并放进 error_keywords。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [223] （社区）　Node 'ID #267:275' has no class_type. The workflow may be corrupted or　https://huggingface.co/Volkin/LTX-2.3-Workflows/discussions/1
  2. [224] （官方 issue）　Issue with workflow to mix human faces - Cannot execute because a node　https://github.com/Comfy-Org/ComfyUI/issues/11859
  3. [225] （官方文档）　Troubleshooting custom node issues - ComfyUI Docs　https://docs.comfy.org/troubleshooting/custom-node-issues.md

这条报错要用到的东西

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

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库找到对应节点仓库，看它的适配模型 板块 工作流看官方模板里这条工作流本来是怎么连的 板块

同一类别的其他条目

【101】ComfyUI-Manager 连不上 Comfy Registry，刷新缓存失败 含未核实 【102】ComfyUI-Impact-Pack 导入失败：No module named 'ultralytics'（缺少检测模型依赖） 有来源 【103】comfyui_controlnet_aux 导入失败：No module named 'timm' 有来源 【104】WanVideoWrapper：No module named 'sageattention'（SageAttention 未安装或装错环境） 含未核实 【105】VideoHelperSuite：ffmpeg is required for video outputs and could not be found 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库