展开本页目录
开始前准备什么
- 已有本地 ComfyUI 环境；按所用模型官方说明准备硬件和权重。
- 下载本页材料，检查模型家族、目录与来源；模型权重未打包。
- 保留原文件与实际版本，UI workflow 与 API prompt 分开。
- 保留问题 JSON 和版本
- 列出节点 type
- 分清核心与自定义节点
- 检查启动导入错误
- 隔离已有插件冲突
- 重新打开并核对连接
- 保存包版本和修复证明
2026-10-24 核验材料；实际执行范围、结果与限制见下方记录。
补充：原有练习资料与下载
含 UI/单独 API JSON、原输入、模型清单、校验脚本和真实负例；无权重及本次推理输出。
按官方 0.4 格式整理；仅结构核验，需在你的目标版本实际导入。
从本页工作流 Loader 字段读取；按官方来源准备兼容权重。
空结果栏，供你填写实际输出与故障；不预填虚构成功结果。
缺节点原生实测：未知 type、HTTP 400 与内置节点替换对照
原生界面显示未知包与缺失节点，后端返回 missing_node_type；节点清单核对只定位 type，修复对照使用已安装的内置 LoadImage。
· 用明确标注的虚构缺节点名称复现原生错误，并以同任务内置 LoadImage 替换后成功执行；未假定未知名称对应任何 GitHub 仓库。
- 运行环境
- ComfyUI 0.42.0；官方提交 8baf68d53d751216dd95d4f678bf109d82db3442；原生前端 1.57.1，中文界面；Python 3.12.13，CPU；独立本地实例 127.0.0.1:3344；关闭自定义节点与合作伙伴节点，未下载模型权重；输入为本站原创几何测试图，不含用户图片；本地练习无需 apizt API Key
1. 打开明确标注的故障样本
载入 QR-missing-node-native.json；tokenbaNotInstalledNode 是本站特意设置的虚构 type，用于演示原生缺节点表现，不是应安装的真实插件名。
2. 在原生问题面板定位
点缺节点通知「查看详情」，再点定位；画布显示红色未知节点，右侧显示「未知包」。记录精确 type，不能仅用中文显示名猜仓库。
3. 与已安装类型交叉核对
运行 audit_node_types.py；它直接查询原生 /object_info，输出所需三种 type，其中只缺 tokenbaNotInstalledNode。
bashpython3 audit_node_types.py QR-missing-node-native.json --base http://127.0.0.1:81884. 保留后端原始错误
运行 missing-node 诊断，原生 POST /prompt 返回 HTTP 400、missing_node_type，含节点 ID #1；不要把这个名称映射到随意搜索到的仓库。
bashpython3 diagnose_workflow.py --case missing-node --base http://127.0.0.1:81885. 替换为任务所需内置节点
本例用途只是读图，将未知节点换成内置 LoadImage，重新选 proof-a.png、把 IMAGE 接到 ImageScale，再运行 SaveImage；成功输出 256×192。真实插件依赖应先从工作流作者确认仓库/提交与依赖，再在独立环境验证。
这次实际得到什么
- 原生中文界面识别缺少节点 tokenbaNotInstalledNode，并显示未知包；未安装或推荐任何虚构插件。
- 原生 /object_info 清单可见 LoadImage、ImageScale、SaveImage，不含故障样本 type。
- 原生 HTTP 400 的 missing_node_type、node_id=1 与画布红框一致；内置 LoadImage 替换对照成功输出真实 PNG。
使用这份结果时注意
- 故障名称为可复现测试夹具，未声称排查了某个真实第三方插件的导入依赖冲突。
- 本实例禁用了全部自定义节点；某真实节点缺失时还需区分未安装、启动参数禁用、导入失败与版本改名。
- 未修改用户插件目录或全局 Python 环境。
1. 保留问题 JSON 和版本
下载 negative-unknown-node.json，查看其中的 UnknownTeachingNode；这是刻意缺节点教材。你的工作流也应原样另存，不先删除红节点，记录 frontend 与 backend 版本。
2. 列出节点 type
运行 python check.py negative-unknown-node.json，它应列出未知 type。再对自己的 JSON 做类型清单，优先查 properties 的 cnr_id、aux_id 与 ver，并访问官方 Registry 或仓库确认身份。
3. 分清核心与自定义节点
若 type 属于核心，确认 ComfyUI 当前版本是否支持该节点；若来自自定义包，记录精确仓库地址和依赖。不要因显示名相似就装另一个包，更不直接运行来源不明的一键安装脚本。
4. 检查启动导入错误
打开真实终端日志搜索 IMPORT FAILED、ModuleNotFoundError 和对应包路径。装了文件夹不代表模块成功导入；应在这一 ComfyUI 的 Python 环境按包说明处理依赖。
5. 隔离已有插件冲突
在保留环境与工作流备份后，可用 --disable-all-custom-nodes 测核心基础图；再按官方二分法逐组启用定位冲突。禁用后自定义工作流缺节点是预期现象，不能误报为新故障。
6. 重新打开并核对连接
重启后重新加载原文件，检查目标 type 是否解析、widgets 是否保留以及连线是否恢复。替代节点需要按输入输出重新搭建和验收，不通过改 type 字符串假装迁移。
7. 保存包版本和修复证明
记录最终仓库版本、依赖命令、启动日志和 JSON；先用最小样例检查。素材包仅验证未知类型会被离线校验拒绝，不宣称替你安装了任何自定义节点。
8. 下载工作流、输入和结构检查
完整包包含官方来源 JSON、按本页整理的 UI workflow、单独的 API prompt、真实输入 PNG、模型与参数清单、空验收表、故障负样本和离线脚本。先执行 python check.py，再在自己的 ComfyUI 安装中导入与实际运行。包内权重未下载，结构检查不能替代前端兼容与推理验收。
怎样确认已经完成
- 未知 type 来自实际问题文件，并能被离线类型核验发现。
- 仓库、版本与 Python 环境清楚，导入日志没有被忽略。
- 重开后检查 widget 与连线，迁移文件与原件分开保存。
常见问题
ComfyUI缺节点报错排查：从 type 清单定位仓库与版本本次实际验证了什么？
原生界面显示未知包与缺失节点，后端返回 missing_node_type；节点清单核对只定位 type，修复对照使用已安装的内置 LoadImage。
本次结果有哪些适用限制？
故障名称为可复现测试夹具，未声称排查了某个真实第三方插件的导入依赖冲突。 本实例禁用了全部自定义节点；某真实节点缺失时还需区分未安装、启动参数禁用、导入失败与版本改名。 未修改用户插件目录或全局 Python 环境。