CUDA out of memory：按加载、采样和解码阶段排查显存
任务在 GPU 上分配内存失败。先定位失败发生在模型加载、采样、VAE 解码还是其他节点，再决定降低哪个负载。显卡标称容量、模型文件体积和本次实际可用显存不是同一个数字。
现象与适用范围
任务在 GPU 上分配内存失败。先定位失败发生在模型加载、采样、VAE 解码还是其他节点，再决定降低哪个负载。显卡标称容量、模型文件体积和本次实际可用显存不是同一个数字。
检索用原文或片段（具体编号、数值和文件名随环境变化）：
CUDA out of memory
torch.OutOfMemoryError
已核对的依据
官方排错资料提供降低分辨率、批量和改变内存策略的方向。PyTorch 明确说明 empty_cache 清理的是未占用缓存，并不会增加 PyTorch 可使用的总显存；仍被活跃张量引用的数据不会因此消失。 D01 P06
需要区分的情况
1. 同一显卡有其他生成进程或多个 ComfyUI 实例占用，当前任务得到的可用空间减少。
2. 输入尺寸、批量、视频帧数或多阶段模型同时驻留导致本次峰值超过容量。
3. 某阶段存在额外工作区、缓存或自定义节点保留张量；不能仅由最后显示的节点判断所有占用来源。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。
第 1 步。 记录错误前最后一个执行节点、申请字节数、GPU 型号、分辨率、批量、帧数及是否开启多路并发。
第 2 步。 停止自己确认不需要的任务，先只排一个任务；仅在具体工作流和模型支持时，才用批量 1 或更小的输入建立对照，不先改变全部算法参数。
第 3 步。 采样阶段仅在工作流和模型允许时缩小画面或时长；解码阶段转到专门的 VAE 排查；加载阶段检查是否误用了更大模型或同时加载多套。
第 4 步。 需要 offload、低显存模式或量化时先查看本版本和具体模型支持条件，在副本中一次改变一个设置并记录结果。
如何判断处理有效
受支持的较小基线能重复完成，并且只改变一个受支持参数时可以解释显存变化。基线成功不能推导原工作负载也一定成功。
注意事项与尚未确认的部分
不要把清缓存、重启或任意 allocator 环境变量写成永远有效的修复。CPU offload 可能转移压力到 RAM，过度减小批量之外的参数也可能改变输出。
资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。
原始资料
- D01 · ComfyUI troubleshooting overview。核对：2026-09-21。
- P06 · torch.cuda.memory.empty_cache。核对：2026-09-21。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- 采样完成后 VAE 解码爆显存：把解码负载单独检查
VAEDecode采样进度已经结束，但 VAE Decode 或视频解码节点失败，导致没有最终图片或视频。这与采样开始就显存不足不同：已经生成的 latent 仍需要进一步转换为像素。 - Windows 错误 1455：分页文件过小不等于显存不足
The paging file is too small for this operation to completeWindows 在加载大模型或运行任务时提示分页文件过小。此错误涉及系统提交内存，不应直接套用 CUDA 显存不足的处理方式，更不能因为发生在 safetensors 加载时就认定权重已损坏。
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排；没有执行、硬件测试或保证修复的结论。
01ComfyUI troubleshooting overview资料核对: 2026-09-2102torch.cuda.memory.empty_cache资料核对: 2026-09-21报告问题 · 78af577c-c297-5597-844d-2cd1bec61c58
相关阅读
编辑为本页关联的条目。
本页整理没有额外硬件时如何建立可比较的小任务基线。目标是找到某个具体环境的可运行范围，而不是从模型名字推测一个对所有人有效的最低显存数字。