ComfyUI 模型问题排查总入口：下拉框为空、加载失败、家族不匹配
按症状排查 ComfyUI 模型问题：先确认 SD1.5、SDXL、Flux 模型家族，再检查模型目录、下拉框为空、模型加载失败、LoRA 和 ControlNet 兼容性。
一句话结论
遇到 ComfyUI 模型问题，不要先重装，也不要先改提示词。先按这条顺序走：模型家族 → 文件类型和目录 → 下拉框是否出现 → Queue 后加载错误 → 显存和画质设置。
上图把模型问题拆成可执行的排查顺序：先确认文件和路径，再看加载错误，最后处理显存和复杂工作流。
模型排错顺序
| 步骤 | 先问的问题 | 去哪里继续 |
|---|---|---|
| 1. 模型家族 | 这是 SD1.5、SDXL、Flux，还是其他体系？ | /guides/sd15-vs-sdxl/ |
| 2. 文件类型和目录 | Checkpoint、LoRA、VAE、ControlNet 分别放对了吗？ | /guides/model-file-paths/ |
| 3. 下拉框为空 | 文件在电脑里，但节点没有识别到吗？ | /guides/model-dropdown-empty/ |
| 4. 加载失败 | 下拉框能选，但 Queue 后报错吗？ | /guides/model-load-failed/ |
| 5. 模型功能不生效 | LoRA、ControlNet、VAE 是不是用错家族或节点？ | /guides/lora-explained/、/guides/controlnet-models/、/guides/vae-explained/ |
这条顺序不能反过来。下拉框为空时，讨论 shape mismatch 太早；模型家族错了，继续调采样器也没有意义；显存不足时，反复换目录也不会解决。
先按症状分流
我不知道该下载 SD1.5 还是 SDXL
先看模型家族。SD1.5、SDXL、Flux 不是同一个模型的高中低画质版本，而是不同生态。Checkpoint、LoRA、ControlNet、工作流节点和推荐分辨率都要跟着家族走。
继续看：/guides/sd15-vs-sdxl/
文件已经下载了，但下拉框为空
这是模型发现问题。先确认文件类型和目录，再确认你放进的是当前正在运行的那一份 ComfyUI。浏览器刷新不等于后端重新扫描模型。
继续看：/guides/model-dropdown-empty/
下拉框能选，但 Queue 后报错
这是加载或运行问题。先读终端错误关键词，不要把所有失败都叫“路径错”。invalid header、shape mismatch、CUDA out of memory 指向完全不同的修复方向。
继续看：/guides/model-load-failed/
导入别人工作流后红色节点
红色节点通常是自定义节点缺失，不等于模型文件缺失。先修节点，再修模型；否则你会把插件问题误判成 Checkpoint 或 LoRA 问题。
继续看：/guides/missing-nodes-fix/ 和 /guides/import-workflow/
30 秒快速检查
- 工作流作者使用的是 SD1.5、SDXL 还是 Flux。
- Checkpoint 是否在
ComfyUI/models/checkpoints/。 - LoRA 是否在
ComfyUI/models/loras/，而不是 checkpoints。 - VAE 是否在
ComfyUI/models/vae/。 - ControlNet 是否在
ComfyUI/models/controlnet/，并且控制类型和模型家族匹配。 - 文件是否还在 zip/7z 压缩包里，或被下载成
.html、.txt、.download。 - 你是否打开了另一份 ComfyUI，模型却放进了旧目录。
- 放完模型后是否点了刷新，或者重启过 ComfyUI 后端。
常见错误关键词怎么判断
| 错误关键词 | 优先判断 | 下一步 |
|---|---|---|
No such file or directory / file not found | 工作流引用的文件名或路径不存在 | 检查文件名、目录、工作流里保存的模型名 |
invalid header | 文件可能下载损坏，或下载成网页 HTML | 重新从可信来源下载，确认文件大小和后缀 |
shape mismatch / size mismatch | 模型家族或节点期望不匹配 | 回到 SD1.5 / SDXL / Flux 兼容性检查 |
CUDA out of memory | 显存不足，不是目录问题 | 降低分辨率、batch、模型规模或启动低显存模式 |
| 下拉框完全为空 | ComfyUI 没发现这个模型类型 | 回到目录、文件类型、刷新、运行实例检查 |
推荐修复路径
新手最稳的修复路径是：先用一个已知可用的 SD1.5 checkpoint 跑通最小工作流，再逐个加入 LoRA、VAE、ControlNet 和外部工作流。每次只改一个变量，才能知道是目录、家族、文件损坏、节点缺失还是显存导致失败。
如果你已经在复杂工作流里遇到多个错误，不要同时修。先让 Load Checkpoint 能看到模型，再让 Queue 成功跑一张基础图，最后才恢复 LoRA、ControlNet、Upscale、IPAdapter 等分支。
验证是否成功
- 你能说清当前工作流属于 SD1.5、SDXL 还是 Flux。
- 对应模型出现在正确节点的下拉框里。
- Queue Prompt 后不再出现文件缺失、下载损坏或家族不匹配错误。
- 同一套最小工作流可以稳定生成一张基础图。
- 复杂工作流的问题可以被拆成节点、模型、显存或画质四类，而不是混在一起处理。