ComfyUI显存报错如何排查

在 ComfyUI 里出现显存（VRAM）报错，通常表现为：

• CUDA out of memory
• OutOfMemoryError
• 画面卡死 / 生成中断
• 某些节点突然失败

下面是一套系统化排查思路，从“最常见”到“进阶”。

一、先确认基础信息（非常重要）

先看清楚报错里有没有这些关键词：

• CUDA out of memory
• allocated X / reserved Y
• fragmentation
• torch.cuda.OutOfMemoryError

同时确认：

• 显卡型号（如 3060 12G / 4090 24G）
• 系统内存（RAM）大小
• ComfyUI 是 原生版 还是 便携版（ComfyUI_windows_portable）
• 是否用了 --lowvram / --medvram

二、最常见原因 & 对应解决办法

1️⃣ 模型太大 + 显存不够（最高频）

典型情况

• 用 SDXL / Flux 但只有 8G / 6G 显存
• 同时加载多个大模型

✅ 解决：

• 启动参数加：

--lowvram

或

--medvram

• 尽量 只加载一个 Checkpoint
• 使用：
• taesd / taesdxl
• fp8 / gguf 模型（Flux 尤其推荐）

2️⃣ 分辨率太高

典型情况

• 直接 1024×1024 或 1280×1280
• 图生图 + 高分辨率修复

✅ 解决：

• 降到：
• SD1.5：512×512
• SDXL：1024×1024 以内
• 用 Ultimate SD Upscale 分步放大

3️⃣ 批处理 Batch Size 太大

典型情况

• batch_size = 4~8

✅ 解决：

• 设成 1
• 需要多图就用队列，不要一次批量

4️⃣ 节点缓存没释放（ComfyUI 特性）

ComfyUI 不会自动清显存，尤其：

• 多次切换工作流
• 连续生成多张

✅ 解决：

• 点 Queue → Clear
• 或按 Ctrl + Shift + R 刷新页面
• 必要时彻底重启 ComfyUI

5️⃣ 使用了高显存节点

常见“吃显存大户”：

• ControlNet（多个）
• IPAdapter
• AnimateDiff
• Stable Video Diffusion
• Upscale Model（ESRGAN 类）

✅ 解决：

• 减少 ControlNet 数量
• 用 ControlNet Preprocessor 提前算
• IPAdapter 用 light 模型

三、进阶排查（还不行再看这里）

6️⃣ 看显存到底被谁吃了

在终端运行：

nvidia-smi

或 Windows 任务管理器 → GPU
看：

• 是否有 其他程序占显存（浏览器、OBS、游戏）
• ComfyUI 是否已占满

7️⃣ 系统内存（RAM）不足

ComfyUI 在低显存时会用 系统内存兜底
如果 RAM 也爆了，会间接导致显存报错。
✅ 解决：

• 关掉 Chrome / Edge
• 加虚拟内存
• 至少 16G RAM（推荐 32G）

8️⃣ 驱动 / CUDA 不兼容

✅ 检查：

• 显卡驱动是否最新
• PyTorch 版本是否正确

便携版推荐：

python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121

四、推荐“稳妥配置”（按显存）

五、如果你愿意，我可以直接帮你定位

你可以贴出：

1. 完整报错截图或文本
2. 你的显卡 + 显存
3. 用的工作流类型（文生图 / 图生图 / 视频）

我可以直接告诉你是哪一步爆的、怎么改参数。