ComfyUI 排错清单
启动失败
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 闪退 | Python/CUDA 不匹配 | 看控制台第一段报错；重装匹配的 torch |
| 打不开 8188 | 端口占用/未启动完成 | 换 --port；查防火墙 |
| 导入节点报错 | custom_nodes 缺依赖 | 进该节点目录装 requirements |
bash
# 看端口（Windows）
netstat -ano | findstr 8188界面有，但不出图
| 检查 | 动作 |
|---|---|
| 有无 checkpoint | 放入 models/checkpoints 后刷新/重启 |
| 队列是否在跑 | 看 Queue；看控制台进度 |
| 红节点 | 缺模型或类型连错 |
黑图 / 噪点图 / 灰图
- VAE 不匹配 → 换模型推荐 VAE
- CFG / 步数极端 → 回到模型文档默认
- 精度/显存模式导致异常 → 试默认启动参数
显存不足（CUDA OOM）
text
优先：
1. 降低分辨率
2. batch_size = 1
3. 关预览大图
4. python main.py --lowvram
5. 少叠 ControlNet + 大视频模型| 场景 | 策略 |
|---|---|
| 文生图 OOM | 边长减 25%–50% |
| 视频 OOM | 减帧数、减分辨率、缩短秒数 |
| 多 LoRA | 先减到 1 个 |
节点缺失（红框）
text
1. 工作流来自他人 → 安装对应 custom_nodes
2. git clone 到 custom_nodes/
3. 安装其 requirements
4. 重启 ComfyUIbash
cd /d D:\AI\ComfyUI\custom_nodes
git clone <节点仓库URL>
cd <节点目录>
pip install -r requirements.txt工作流加载后一堆错误
- 用 同一主版本 ComfyUI
- 先加载官方默认工作流确认环境正常
- 再逐步加载复杂 JSON
- 对照报错模型文件名是否存在
结果无法复现
| 因素 | 处理 |
|---|---|
| seed 随机 | 固定 seed |
| 未保存工作流 | 导出 API JSON |
| 模型文件被换 | 校验文件名与哈希 |
| 非确定性采样 | 接受微小差异或换采样器 |
日志怎么看
控制台典型顺序：
text
加载模型 → 采样 step → 解码 → 保存路径卡在加载：磁盘/模型损坏。
卡在采样：显存或步数太多。
验收
- [ ] 能区分「环境坏了」还是「工作流坏了」
- [ ] OOM 时知道先砍分辨率