36 · 常见问题排查

出图异常、报错、卡顿——ComfyUI 常见问题的快速诊断和修复

01 启动类问题

ComfyUI 打不开 / 闪退

1. 确认 Python 版本：需要 3.10 或 3.11
2. 确认 PyTorch 安装正确：python -c "import torch; print(torch.cuda.is_available())" → 应该输出 True
3. 端口被占用：换端口 python main.py --port 8189

启动后有界面但选不到模型

• 模型放对位置了吗？→ ComfyUI/models/checkpoints/
• 文件名有特殊字符吗？→ 避免中文文件名
• 刷新浏览器（F5）

02 出图类问题

出图全黑

• VAE 没连或连错了
• Checkpoint 文件损坏
• 解决：用 Load VAE 单独加载 VAE，不要依赖 Checkpoint 内置的

出图灰蒙蒙/发白

• VAE 问题——换个 VAE 试试
• 如果是二次元模型，加 kl-f8-anime2 VAE

出图模糊

• steps 太低（< 15）
• CFG 太低（< 3）
• 用的模型本身画质一般

出图有奇怪的噪点

• seed 问题——换个 seed
• 采样器问题——换 euler 试试

多人/重复物体（空间折叠）

• 分辨率超出模型训练范围
• SD 1.5 不要超过 768，SDXL 不要超过 1280
• 超出了就做 Upscale，不要在生成阶段硬来

03 性能类问题

CUDA Out of Memory（爆显存）

按优先级尝试：

1. 减小 batch_size 到 1
2. 降低分辨率
3. 加 --lowvram 启动参数
4. 用 VAEDecodeTiled 代替 VAE Decode
5. 关闭其他占用显存的程序
6. 换更轻量的模型

生成速度太慢

• 检查是否用了 CPU 模式：确认 python -c "import torch; print(torch.cuda.is_available())" 为 True
• 降低 steps（20-25 足够大多数场景）
• 降低分辨率
• 考虑换 SD 1.5 模型

04 节点类问题

节点红色边框报错

• 缺少自定义节点 → 点 Install Missing Custom Nodes
• 模型文件缺失 → 检查对应 models 目录

连线连不上

• 数据类型不匹配（颜色不同）→ 检查输出输入类型
• 中间需要转换节点

工作流拖进来一片空白

• 工作流 JSON 里有你没装的节点 → 先 Install Missing
• JSON 格式错误（不完整）

05 模型类问题

下载的模型用不了

• 文件不完整（下载中断）→ 重新下载
• SD 版本不匹配 → 确认是 SD 1.5/SDXL/Flux
• 文件损坏 → 用 safetensors 格式，避免 ckpt

LoRA 加载了但没效果

• 触发词没写
• LoRA 权重太低（< 0.3 几乎不可见）
• LoRA 基础模型和你用的 Checkpoint 不匹配

06 诊断三步骤

遇到任何问题，按这个顺序查：

1. 看终端：ComfyUI 的黑窗口里有什么红色报错？
2. 看节点：哪个节点是红色的？
3. 简化工作流：一个节点一个节点 Bypass，定位问题在哪个环节

💡 一句话总结：出图黑检查 VAE、出图崩查模型匹配、爆显存加 lowvram——终端报错信息是问题定位的第一线索。