报错
079
前端界面、浏览器与工作流加载
有来源可查
工作流所有节点变红、提示缺少节点或 Cannot find node,无法执行
报错原文(原样)
invalid prompt: {'type': 'invalid_prompt', 'message': 'Cannot execute because a node is missing the class_type property.', 'details': "Node ID '#46'", 'extra_info': {}}
Cannot execute because a node is missing the class_type property.: Node ID '#46'
检索关键词
Cannot find node、is missing the class_type property、Node ID '#46'、invalid_prompt、Install Missing Custom Nodes、节点变红、缺少节点
先看这一句
打开别人的工作流后一片红,或执行时弹出 "Cannot execute because a node is missing the class_type property.: Node ID '#xx'",整条工作流无法运行;有时工作流甚至根本打不开。
适用版本 全版本通用;升级到 frontend v1.39.5+ 后错误提示会明确给出缺失节点名。桌面版按 christian-byrne 的说法会在随后一个 stable 版本收到该改进
·
核实日期 2026-09-26
·
状态 已核实
适用环境:Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境
现象与触发场景
常见触发场景:
- 打开从网上下载、别人分享的工作流,本机没装对应自定义节点
- 更新或重装 ComfyUI 后,自定义节点没跟着更新、甚至没能成功导入
- ComfyUI-Manager 未安装,界面上看不到缺失节点安装入口
- 节点前端/后端版本不匹配,节点在 /object_info 里缺失
根因
- 工作流引用的节点类在服务器端的 /object_info 里不存在,后端因此拿不到 class_type。维护者 christian-byrne 在 ComfyUI#8903 中直接指出该例的根因是 "Nunchaku is failing to import",即节点自身的 Python 导入失败而不是工作流坏了
- 该错误信息过于含糊,官方已确认这是提示语缺陷:christian-byrne 在 ComfyUI#8903 说明 frontend v1.39.5(后端 ComfyUI#12177、前端 ComfyUI_frontend#8511)之后才会显示真正缺失的节点类型、节点自定义标题以及 "安装缺失自定义节点" 的提示
- 缺少节点时工作流加载行为本身也有限制,ComfyUI_frontend#6328 的标题即 "Workflow does not load when nodes are missing, so the workflow cannot be fixed in the UI."
解决步骤
已按「最可能有效」排序。请从上往下做,每做完一步用「验证」确认,不要一次改五处。
- 先让错误信息变明确,并确认节点是不是根本没导入成功如果报错里只有 Node ID,先升级前端到 v1.39.5+,之后同一处会直接打印缺失的节点类型名。同时回到启动 ComfyUI 的终端窗口,从启动日志里搜该节点相关的 ImportError / ModuleNotFoundError / traceback:节点导入失败与工作流缺节点表现相似,但修法完全不同。python main.py --front-end-version Comfy-Org/ComfyUI_frontend@1.39.5python main.py --enable-manager
- 用 ComfyUI-Manager 安装缺失节点打开 Manager,先点 "Install Missing Custom Nodes"(安装缺失的自定义节点),它会比对当前工作流引用的节点与本地已装节点,列出可安装项;也可以直接在 Manager 的节点列表里搜节点名安装。装完必须完整重启 ComfyUI(不是只刷新网页),再重新打开工作流。python main.py --enable-manager
- 节点来源不明或不在注册表时,手工安装或改用替代节点christian-byrne 在 ComfyUI#8903 明确说过:如果节点来源显示为 Unknown,是因为 Manager 没装、或该节点不在节点注册表里。这种情况要按工作流作者给出的仓库地址手工克隆到 custom_nodes 下再装依赖,或者直接用功能等价的内置/其他节点替换,不要长期带着红节点跑。
验证是否修好
重新加载工作流后不再出现红节点,队列执行时不再抛出 "is missing the class_type property";在 F12 Console 或浏览器请求 http://127.0.0.1:8188/object_info 中能搜到该节点类名。
补充说明
ComfyUI#8903 与 ComfyUI#11859、ComfyUI#9656 是同一句报错的不同实例,本条只引用已取到完整正文与维护者回复的 #8903。/object_info 在官方 comms_routes 文档的路由表里未单独列名,此处仅作为自测手段引用;该接口在 ComfyUI#7329 的讨论中被维护者与用户直接用作诊断对象。
来源
按可信度排列:官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。
链接以纯文本给出(本站不做站外跳转),需要核对时请自行复制到浏览器打开。
- [185] (官方 issue) Cannot execute because a node is missing the class_type property.: Nod https://github.com/Comfy-Org/ComfyUI/issues/8903
- [186] (官方 issue) Workflow does not load when nodes are missing, so the workflow cannot https://github.com/Comfy-Org/ComfyUI_frontend/issues/6328
- [68] (官方文档) Troubleshooting Custom Node Issues https://docs.comfy.org/troubleshooting/custom-node-issues
- [187] (官方 issue) Loading Workflows with Missing Nodes https://github.com/Comfy-Org/ComfyUI/issues/6844
这条报错要用到的东西
按本条报错所属的类别(前端界面、浏览器与工作流加载)列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」,而是这一类问题里最常要动到的东西;具体怎么做,以上面的解决步骤为准。
常用节点速查包常用节点参数小抄 / 常见连法示意图
待挂载
工作流换一条已知结构完整的工作流对照排查
板块
同一类别的其他条目
【078】打开 127.0.0.1:8188 只有空白页或一直转圈,界面加载不出来
有来源
【080】新版前端与旧工作流不兼容:旧工作流节点错位、widget 丢失或值变成 undefined
有来源
【081】浏览器控制台报 Failed to load resource: ERR_CONNECTION_REFUSED,页面打不开或功能全失效
有来源
【082】出图成功但看不到图:预览 404、保存的图片找不到
有来源
【083】WebSocket 断开/Reconnecting,进度条卡在 0% 但后端其实已经出图
有来源
这个解法对你有效吗
记录只存在你自己的浏览器里,不需要注册账号。
知仓学习社