# ComfyUI缺节点报错排查

读取工作流中的节点 type 和节点属性，分清核心更新、自定义节点未装和导入失败，并保留环境回滚点。

本地结构与素材核验，未执行 ComfyUI 前端导入或扩散/ESRGAN 推理。图像与原 JSON 来源见 provenance.json。所有工作流为 UI 格式 0.4，与 prompt-api.json 分开。权重不打包。

## 使用

1. python check.py
2. 查看 models.csv，按模型出处准备文件。
3. 用本地 ComfyUI 打开 workflow.json，重新选择 Loader 下拉和输入。
4. 自己完成真实小样，填写 acceptance.csv。

## 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；先用最小样例检查。素材包仅验证未知类型会被离线校验拒绝，不宣称替你安装了任何自定义节点。


queue_client.py 默认只查询；--submit 明确触发本地真实推理。batch_manifest.py 仅生成计划，未提交。故障日志、history 响应和空验收栏是教材，不是本站成功实测。

## 官方来源

- https://docs.comfy.org/tutorials/basic/text-to-image
- https://github.com/Comfy-Org/ComfyUI
- https://docs.comfy.org/troubleshooting/custom-node-issues
- https://www.douyin.com/video/7691594447310244330