知仓学习社知仓学习社
VAE 解码阶段爆显存：Ran out of memory when regular VAE decoding, retrying with tiled VAE decoding / 全站资源搜索
搜索 更新 2026-10-02
报错 014 显存与内存不足（OOM） 有来源可查

VAE 解码阶段爆显存：Ran out of memory when regular VAE decoding, retrying with tiled VAE decoding

报错原文（原样） 
Warning: Ran out of memory when regular VAE decoding, retrying with tiled VAE decoding.
检索关键词 Ran out of memory when regular VAE decoding、retrying with tiled VAE decoding、VAE Decode (Tiled)、torch.OutOfMemoryError、VAEDecode
先看这一句 采样阶段一切正常，进度条走到 VAE Decode 才炸；或控制台提示已自动改用分块解码，但图像变黑、出现接缝、视频音轨变得莫名其妙。
适用版本 全版本通用；AMD ROCm 环境更容易触发（issue #9547 报告 7900XT 每次重启后只有第一次解码正常）。 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 1024 以上大图或高分辨率放大后的 VAE 解码
  • 视频模型（Wan / HunyuanVideo / LTX-2 / SVD）逐帧解码，帧数一多就爆
  • AMD ROCm 用户首次解码正常、第二次开始退化为分块解码并出现黑图
  • 音频 VAE 的 tiled 编码（已知会产生静音输出）

根因

  • VAE 解码的显存峰值随输出像素数（宽 × 高 × 帧数）线性增长，且解码时需要同时持有 latent 与解码中的特征图，峰值往往超过采样阶段。
  • ComfyUI 已内置兜底：常规解码 OOM 时自动退回分块（tiled）解码，因此看到的是 Warning 而不是崩溃；但分块解码在某些模型/后端上会带来画质或音频正确性问题。
  • 退化为分块解码的根本原因常常是显存里还残留着上一个模型的权重没有被释放，官方 PR #15456 就是在修“重试分块解码前先释放其它模型显存”这个路径。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 主动改用 VAE Decode (Tiled) 节点，别等它兜底
    ComfyUI 内置 VAEDecodeTiled 节点，官方文档说明它通过把图像切成小块逐块解码来降低峰值显存。把工作流里的 VAEDecode 换成 VAEDecodeTiled，并按需调小 tile_size；视频工作流用带 tiled 字样的视频 VAE 解码节点。
    # 节点替换：VAEDecode -> VAEDecodeTiled
    # 视频：使用对应模型的 'VAE Decode (Tiled)' 变体节点
  2. 开启 --disable-smart-memory 让上一个模型先释放
    issue #9547 中用户明确确认 `--disable-smart-memory` 修好了他“后续每张图都退化成分块解码/黑图”的问题。它强制 ComfyUI 积极地卸载模型到普通内存，从而在 VAE 解码时有连续显存可用。
    python main.py --disable-smart-memory
    python main.py --listen --preview-method taesd --fp16-vae --use-split-cross-attention --disable-smart-memory --cache-none
  3. 降低 VAE 精度或把 VAE 放到 CPU
    用 --fp16-vae 或 --bf16-vae 让 VAE 以半精度运行，显存占用近乎减半（--fp16-vae 的 help 注明可能导致黑图，AMD 上优先试 --bf16-vae）；如果仍然 OOM，用 --cpu-vae 把 VAE 完全放 CPU 运算，代价是解码变慢。
    --bf16-vae
    --fp16-vae
    --cpu-vae

验证是否修好

解码结束后控制台不再出现 tiled VAE 的 Warning；对比解码前后图像（视频）无黑图、无接缝、音轨正常。

补充说明

issue #12326 的补充事实：tiled 模式下“VAE encode audio does not work”，短音频不走分块则正常，属于分块音频编码的已知缺陷，视频带音轨的工作流要避开 tiled 音频编码节点。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [41] （官方 issue）　VAE decoding on AMD works first time only before switching to tiled or　https://github.com/Comfy-Org/ComfyUI/issues/9547
  2. [42] （官方 issue）　Free other models' memory before retrying handles_tiling VAE decode (P　https://github.com/Comfy-Org/ComfyUI/pull/15456
  3. [43] （官方文档）　VAEDecodeTiled - ComfyUI Built-in Node Documentation　https://docs.comfy.org/zh/built-in-nodes/VAEDecodeTiled
  4. [44] （官方 issue）　Flux2: torch.OutOfMemoryError: Allocation on device · Issue #10891　https://github.com/Comfy-Org/ComfyUI/issues/10891

这条报错要用到的东西

按本条报错所属的类别（显存与内存不足（OOM））列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

ComfyUI 权重库（167 个文件 / 约 1187 GB）按 ComfyUI 的 models 目录分好类的 167 个权重文件 / 每个文件一份说明（放哪、被哪些工作流引用） 待挂载
权重库同一个模型常有更小的量化版本，换一个能省一大截显存 板块 工作流换一条依赖更轻的工作流 板块

同一类别的其他条目

【012】最典型的爆显存：KSampler 阶段 torch.cuda.OutOfMemoryError: CUDA out of memory. Tried to allocate ... 有来源 【013】新版报错：torch.OutOfMemoryError: Allocation on device 0 would exceed allowed memory.（附带 batch_size TIPS） 有来源 【015】系统内存/页面文件不足：OSError: The paging file is too small for this operation to complete. (os error 1455) 含未核实 【016】Windows 共享显存（Shared GPU memory）被吃满，任务管理器显示显存未释放、必须重启 含未核实 【017】显存明明还有空余却报 OOM：分配器碎片化与 soft_empty_cache 未回收 含未核实
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库