出图失败通常与显存、模型、节点相关,按顺序排查。
现象一:显存不足(Out of Memory)
- 现象:点 Run 后报 CUDA out of memory / 显存不足;
- 解决:
- 点击实例 GPU 徽标清理显存(见「GPU 监控与显存清理」);
- 降低分辨率 / batch size / 关闭多余标签页;
- 停止其他实例释放整卡显存;
- 开启「CUDA 内存池」优化(见「GPU 优化开关」)。
现象二:模型未下载 / 路径错误
- 现象:报错提示找不到 checkpoint / 模型文件;
- 解决:
- 到「模型」页确认所需模型已导入 / 下载;
- 检查模型目录配置(含额外路径 / 多盘映射);
- 模型名与实际文件不一致时,重新选择节点中的模型。
现象三:节点缺失 / 依赖未安装
- 现象:工作流加载后红点报错,提示找不到节点类型;
- 解决:
- 到「插件」页搜索安装对应插件;
- 对插件执行「安装依赖」;
- 重启 ComfyUI 后重新加载工作流。
现象四:出图质量异常
- 现象:出图全黑 / 花屏 / 色彩异常;
- 解决:检查 VAE 是否缺失或选错;显存不足时也可能产生异常图,先清理显存重试。
提示:把报错截图 + 控制台日志一起反馈,定位最快。