| 现象 | 原因 | 解决 |
|---|---|---|
| 输出纯黑画面 | INT8 ConvRot 的 VAE 需要新版内核；fp16 手动转换在部分卡上溢出 | 升级 ComfyUI ≥0.31（含 int8 VAE 支持）；用 --fp16-unet 黑屏的卡（V100 等）需要专门的 fp16 修复补丁 |
| 长片段出现灰色噪点/雪花 | SageAttention 在超长序列（约 16 万 token 以上）有静默噪声 bug | 长片改用 comfy-kitchen 注意力后端，或 KJNodes 的 Patch Sage 节点，或缩短时长分段生成 |
| 视频模糊 / 有接缝方块 | VAE 解码显存不足时静默回退到分块解码 | 降低峰值需求（关掉其它占显存程序），或直接降低分辨率；不要硬拉高分辨率抽卡 |
| 现象 | 原因 | 解决 |
|---|---|---|
| 声音断续 / 爆音 / 词错 | 视频与音频是两条采样调度；步数太少时音频被过度采样（尤其 4 步） | 换 6-8 步，或使用支持双时钟调度的采样器（larry LoRA 必须配双时钟采样器） |
| 音频抽样参数建议 | 官方模板默认值与蒸馏 LoRA 不完全一致 | 常用组合：video sigma shift 12 / audio shift 3；采样器 res_multistep 或 euler + simple |
| 旧版本音频全错乱 | ComfyUI 0.30 之前音频在采样器里的传递方式不同 | 升级到 ≥0.30（首次修复合并），建议直接用 0.34+ |
| 现象 | 原因 | 解决 |
|---|---|---|
| 显存不足 OOM | 权重 + 激活值 + 缓存超限 | 加 --lowvram；降分辨率/时长；换更低量化（GGUF Q3/Q4、W4A8）；关闭浏览器硬件加速等占显存程序 |
| 速度远低于预期 | 注意力后端没开 / LoRA 每步重打补丁 / 走了页文件 | 用 Sage 或 Kitchen 注意力；低显存 + 量化 + LoRA 时优先用「融合了 LoRA 的权重」（省掉每步 patch）；任务管理器确认没有大量页文件读写 |
| 一条比一条慢，最后崩溃 | ComfyUI 在故障前会先降速（约 1.8×），常见于长时间连续采样 | 发现规律性变慢就重启 ComfyUI；批量出片拆成批任务，中间重启一次 |
| 切换 LoRA 节点后爆显存 | Turbo 采样节点与原生节点切换时旧显存不释放 | 切换前重启 ComfyUI（社区踩坑记录最多的一个） |
| 现象 | 原因 | 解决 |
|---|---|---|
| Windows 读取大模型崩溃 | mmap 读取超过 20GB 的 safetensors 会崩 | 启动加 --disable-mmap（ComfyUI ≥0.31） |
| LoRA 加载了但没效果 | diffusers 格式的 H3 LoRA 不能直接用于 ComfyUI（键位不同） | 用经过验证的转换版（qkv 融合、fc1 半边互换），不要用原版 diffusers 文件 |
| GGUF 报形状错误 / 与内存优化节点冲突 | 部分优化节点会把 GGUF 容器形状当成权重形状读 | GGUF 场景不要叠加此类内存优化节点；用平台自带的卸载策略 |
| 找不到 MiniMax H3 节点 | 版本太旧 | 升级 ComfyUI ≥0.30（0.30.0 起原生支持），模板库 → Video 里选 H3 工作流 |
| 显存峰值居高不下 | ComfyUI 的动态显存会顶到上限运行，属正常行为 | 不用恐慌；看的是"是否触发页文件/是否 OOM"，而不是峰值数字本身 |
--fast-disk（内存紧张）与 --disable-mmap（Windows）；显存和时间的预期，可以先在 WhichH3 计算器 里按你的硬件跑一遍， 确认"应该花多久、应该用多少显存"，再对照实际表现定位问题。