Node has no class_type:区分错误导出与真正缺少节点
提交的工作流中某个节点缺少 API 执行所需的 class_type。相同 missing_node_type 错误分类还可能用于类名存在但服务端不认识,因此必须同时查看 message 和 extra_info。
现象与适用范围
提交的工作流中某个节点缺少 API 执行所需的 class_type。相同 missing_node_type 错误分类还可能用于类名存在但服务端不认识,因此必须同时查看 message 和 extra_info。
检索用原文或片段(具体编号、数值和文件名随环境变化):
has no class_type
missing_node_type
已核对的依据
核心 validate_prompt 分开检查缺少 class_type 与 NODE_CLASS_MAPPINGS 中找不到类。历史 issue #6366 和 #12105 都出现过相关提示,但单个用户更新节点后恢复不代表全部问题都要升级 nightly。 C01 I08 I13
需要区分的情况
1. 把画布 UI JSON 直接当作 /prompt 的 API 格式提交。
2. 导出、手工编辑或第三方转换时丢失节点类型。
3. 当前前端或自定义节点无法正确序列化某个节点,或者服务端未注册该类。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案,不代表上游已经为你的环境确认了原因。
第 1 步。 确定文件用途,查看失败节点是否具有 inputs 与 class_type,而不是仅有 UI 的 type、位置和连线数组。
第 2 步。 从能够正常打开的工作流重新使用当前版本支持的 API 导出方式,保留原始文件作为对照。
第 3 步。 若 class_type 已存在但服务端不认识,转查 /object_info 和启动日志,确认节点注册状态。
第 4 步。 只有对应节点或版本的官方修复明确适用时再更新;不要把所有节点统一填成 KSampler 或按显示标题猜测类名。
如何判断处理有效
API 格式包含有效类型并通过服务端校验;如果后续返回其他 node_errors,应按新的具体错误继续排查。
注意事项与尚未确认的部分
显示标题可以由用户修改,不是可靠的 Python 类名。工作流格式转换需要理解节点输入,不是简单字段改名。
资料核对日期:2026-09-21。本站未执行此工作流,未进行 GPU、最低显存或耗时测试。
原始资料
- C01 · ComfyUI execution.py validation。核对:2026-09-21。
- I08 · Node has no class_type。核对:2026-09-21;原始日期:2026-01-27。
- I13 · Missing class_type in custom node workflow。核对:2026-09-21;原始日期:2025-01-06。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- ComfyUI 导入后缺少节点:区分未安装、未注册和加载失败
Missing Node Types适用于导入他人工作流后出现红色缺失节点、运行时找不到节点类型的情况。先保存工作流副本和原始下载地址;不要把“缺失节点”自动理解成电脑里完全没有相关文件。 - POST /prompt 返回 400:先读 error,再看 node_errors
prompt_outputs_failed_validation原生 ComfyUI API 拒绝提交工作流。HTTP 400 只说明这次请求不符合要求,具体原因应从 error 与 node_errors 中提取,不能一律当成网络不稳定重试。
这篇内容对你有帮助吗?
匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排;没有执行、硬件测试或保证修复的结论。
01ComfyUI execution.py validation资料核对: 2026-09-2102Node has no class_type资料核对: 2026-09-2103Missing class_type in custom node workflow资料核对: 2026-09-21报告问题 · 59afc12c-8243-5a53-924c-a610df12bbc2
相关阅读
编辑为本页关联的条目。
本指南面向调用自有或获授权 ComfyUI 实例的开发者。网站提供的 MCP 与 ComfyUI 原生 HTTP API 是两套不同接口;这里讨论后者,不涉及自动登录第三方平台或绕过访问限制。