报错修复
CUDA out of memory 解决：ComfyUI 显存不足处理清单
降低分辨率、换轻量模型、开启低显存参数是最常用解法。
一句话结论
能快速把 OOM 工作流降到可运行状态。
这篇解决什么问题
CUDA out of memory 表示显存不够，不是内存条不够。解决思路是减少显存占用：尺寸、batch、模型、插件、后台进程。
如果你是第一次接触 ComfyUI，建议不要跳步。先把最小流程跑通，再安装插件、导入复杂工作流或追求高分辨率。ComfyUI 的大多数问题都可以通过“看控制台日志、确认目录、确认版本、降低参数”这四件事定位。
适合谁
- 刚开始使用 ComfyUI，需要一篇可以照着做的教程。
- 已经遇到相关报错，但不知道该先检查哪一步。
- 想把安装、模型、插件、工作流整理成可复查流程的用户。
准备条件
- 知道显卡显存容量。
- 能看到报错发生在哪个节点。
这张图改成了稳定的降参顺序标注，不再依赖本机 8188 页面截图。OOM 不要先重装 ComfyUI，先确认自己机器的可用显存，再把批量、尺寸、模型和附加模块降下来。
能跑通后再一点点加回去；每次只改一个参数，才知道是哪一步把显存打满。
操作步骤
- 先把 batch_size 改成 1。
- 把尺寸降到 512×512 或 512×768，SDXL 可先降到 768×768 测试。
- 关闭浏览器里其他占 GPU 的应用和游戏。
- 使用 SD1.5 替代 SDXL，或选择 fp16/低显存友好模型。
- 减少 ControlNet、IPAdapter、放大等附加模块。
- 启动参数尝试 —lowvram 或 —normalvram，按显存情况选择。
- 如果是放大阶段 OOM，降低 upscale 倍率或分块放大。
判断问题属于哪一类
- 如果页面打不开，先看启动窗口是否还在运行，以及端口是否正确。
- 如果节点是红色，优先处理缺失自定义节点或插件加载失败。
- 如果模型下拉框为空，优先检查模型类型和放置目录。
- 如果开始生成后失败，优先看显存、模型版本和具体报错节点。
- 如果更新后才坏，优先考虑插件版本不兼容，必要时回退或临时移除插件。
常见错误
- 只重启 ComfyUI，不降低任何参数。
- 把系统内存当显存扩容。
- 同时开多个 ComfyUI 或其他 AI 程序。
验证是否成功
- 同一工作流降低参数后能跑完。
- nvidia-smi 显示显存峰值低于总显存。
如果仍然失败
请把控制台里从 Traceback 开始到最后一行的完整报错保存下来，同时记录：ComfyUI 版本、启动方式、显卡型号、显存容量、使用的模型文件名、刚安装过哪些插件。不要只截网页上的红色提示，因为真正有用的信息通常在启动窗口里。
如果你在本站提交反馈，登录状态下会自动附带 user_id，方便后续追踪同一个用户遇到的连续问题；未登录也可以匿名提交。
下一步推荐
- 新手路线：/topics/comfyui-beginner/
- 报错排查：/topics/comfyui-errors/
- 模型基础：/topics/model-basics/
- 插件安装：/topics/must-have-plugins/
更新记录
- 2026-05-12：扩写为正式教程，补充操作步骤、常见错误和验证清单。