ComfyUI 常见报错排查手册：装不上、跑不动、图不对
作者：夸父
ComfyUI 接入逐日 AI 前后的高频报错排查：安装与依赖、模型加载失败、显存不足、节点缺失、工作流出图异常。每条按"报错现象 → 原因 → 处理动作"组织。
装不上 / 起不来
Python 版本冲突：ComfyUI 对 Python 版本敏感（3.10/3.11 最稳），系统默认 Python 太新会导致依赖装不上。处理：用 conda 或 venv 单独建环境，不要用系统 Python。
依赖安装失败（torch 装成 CPU 版）：症状是能启动但推理极慢。原因多半是 pip 默认源装了 CPU 版 torch。处理：按 CUDA 版本从官方 index 重装 GPU 版 torch，装完用一行代码验证 torch.cuda.is_available() 返回 True。
端口被占用：默认 8188 端口被占，换端口启动，逐日 AI 里的 ComfyUI 地址同步改。
模型相关
model not found / checkpoint error：模型文件没放到 ComfyUI 的 models 目录对应子目录（checkpoint/loras/vae 各有各的位置），或文件名与工作流引用不一致。处理：对照工作流报错里的路径，把文件放对位置。
模型下载不完整：大文件中断导致半包，症状是加载时报 safetensors 解析错误。处理：删除重下，校验文件大小与官方一致。
显存相关
CUDA out of memory：显存不够。按顺序试：关掉其他占显存的程序（浏览器硬件加速也在内）；降低出图分辨率；ComfyUI 启动参数加低显存模式；最后才是换更大显卡。判断显存是否吃紧：合成时开 nvidia-smi 看占用，顶到 100% 就是它。
速度极慢（几分钟一张图）：九成是 CPU 在跑推理。用上面的 torch 验证确认 GPU 可用；再确认工作流没有被切到 CPU 模式。
节点相关
Node missing / import failed：工作流用了你没装的节点包。处理：用 ComfyUI-Manager 按缺失节点名一键安装；装完重启 ComfyUI。
节点版本不兼容：老工作流在新版节点上报参数不匹配。处理：Manager 里把对应节点包更新到与工作流匹配的版本，或用工作流里内嵌的默认值重连。
出图不对（不报错但结果差）
- 画面糊/噪点密：采样步数太低或 VAE 不匹配，检查 VAE 是否与模型配套。
- 人物崩坏：权重太低/太高都会崩，调整 CFG 与采样器组合；角色一致性需求看角色一致性方案。
- 同样的提示词结果不稳定：这是随机种子的作用，需要复现就固定 seed，见随机种子是什么。
接入逐日 AI 前的验收清单
生一张图 → 生一张带参考图的图 → 跑一次完整工作流 → 在逐日 AI 模型配置里填 ComfyUI 地址并连通测试。四步全绿再开始正式生产。
常见问题
ComfyUI 免费吗？
ComfyUI 本体开源免费，跑在本机时没有软件费用；成本只在模型权重下载（一次性）和你的电费/显存。这也是它对日更创作者有吸引力的原因——生图环节的边际成本接近零。
ComfyUI 需要多强的显卡？
生图建议 8GB 显存起步（SDXL 系），要做视频生成或数字人口型同步建议 12GB+。显存不够的表现不是报错就是极慢，本文显存一节有自查方法。
报错信息一大段英文怎么快速定位？
看最后一段堆栈的第一行和包含 Error/Exception 的那一行，把关键词（如 CUDA out of memory / model not found / Node missing）到本文对应小节对号。