镜头失败诊断：60 秒定位问题
AI 视频生成失败只有两种：跑不出来（排队、报错、卡住、中断）和跑出来不对（崩坏、脸漂、不按提示词动）。病根在不同的层——改错层，重抽一百次也是白烧。
这一页是本课程设计的分诊流程：60 秒先定位到层，再对号入座。本地 ComfyUI 的具体报错原文不在本页展开，去 comfyui 栏目的排错手册按原文对号；每条建议都标了适用环境（云端 / 本地 / 通用）。
学完你能做什么
- 60 秒内把一次失败分成两层：跑不出来（环境层）还是跑出来不对（内容层），并说出第一步查什么
- 说得出云端与本地的排查起点：云端看任务状态，本地看 ComfyUI 服务端控制台的报错原文
- 三类内容问题——画面崩坏、角色不对、动作不符——对表分诊，知道该改提示词、换首帧还是换景别
- 本地显存不够时按顺序走降级路线：认对模板 → 降尺寸帧数 → 系统参数 → 社区量化版（标「社区资源」）
- 知道什么时候停手：每镜重试 3 次封顶，交给 4.5 的降级路线
你现在的困境
- 「点了生成，图生视频卡在半路——不知道是云端在排队、本地显存爆了，还是真挂了」
- 「视频是出来了，可老陈的脸糊成一团，手还和蛋糕盒长在一起——不知道该改提示词还是换图」
- 「提示词写摔进水洼，他偏偏原地转圈；重抽三次，三次都转——这才明白不是运气问题」
什么时候用这一招
当你需要：
- 失败之后先定位再动手，把「为什么失败」变成「改哪一个变量」
- 云端点数、本地电费都花在刀刃上——必然失败的问题不交给抽卡
而且不想：
- 提示词、首帧图、尺寸一起改，成了也不知道是哪个起作用
- 抽到第 8 次才发现这一镜根本生成不出来
🎒 开始前的准备
- 完成了 4.1 第一个镜头：见过一次成功，才知道失败卡在哪一环
- 手里有 2.4 分镜表 和三段固定文字：3.1 角色卡、3.3 场景卡、3.4 风格卡——诊断内容问题要拿它们对照
- 说得出自己的环境：云端（Comfy Cloud 等）还是本地 ComfyUI——分不清回 1.3 两条路线
- 每次生成的文件都留着，按 3.5 命名规范 带版本号——诊断靠对比版本
核心思路
失败先分两层，层不同，动作完全不同（本课程设计的教学流程）：
| 层 | 典型症状 | 第一步 |
|---|---|---|
| 环境层：跑不出来 | 排队、失败、中断、卡死、节点报红 | 先分云端还是本地，查「跑不出来」一组 |
| 内容层：跑出来不对 | 画面崩坏、角色不对、动作不符、首尾帧两头对不上 | 对「跑出来不对」分诊表，改一个变量再试 |
环境层的问题重试没用——显存不够就是不够；内容层的问题盲抽也没用——提示词里的病根每次都长出同一个果。
诊断三律（本课程设计）：
- 一次只改一个变量：提示词、首帧图、尺寸、工作流，一次动一样
- 改之前先归档：失败版本按 3.5 命名规范 留着，对比才知道改没改对
- 重试计数，3 次封顶：到了上限交给 4.5 重试与替换策略，别恋战
首次排查：60 秒速检
对着五条自问一遍，一分钟内定位到层和组（本课程设计的分诊问题清单）：
# 1. 视频出来了吗？——没出来 → 环境层，接着问 2、3；出来了但不对 → 内容层，直接问 4
# 2. 云端还是本地？——云端：看平台任务状态和报错提示；本地：翻 ComfyUI 服务端控制台找报错原文
# 3. 本地跑的哪套模板？——"Wan2.2 5B"（官方口径 8GB 显存可跑）还是
# "Wan2.2 14B I2V" / "Wan2.2 14B FLF2V"（官方仓库脚本单卡口径 80GB）——跑不动先降尺寸和帧数
# 4. 内容问题哪一类？——画面崩坏 / 角色不对 / 动作不符；首尾帧镜头另查两头
# 5. 这镜重试几次了？——3 次封顶，超了停手去 4.5问完第 1 条就知道去哪一组。
常见问题排查
跑不出来：生成不了、卡住与中断（AI 视频生成失败）
云端：任务排队很久，或者直接失败【环境：云端】
原因：云端任务要过排队、平台资源、模板与账号状态几道关；具体报错各平台说法不同，本课程未核验各云端平台的报错文档。
解决：
- 刷新任务列表或重进工作流页，确认任务是排队中、运行中还是已失败
- 降一档规格再投一次：尺寸调小、时长调短（ComfyUI 系工作流里就是帧数 length）
- 连续两次失败就停：查阅所用平台的官方文档或联系平台支持，带上报错提示原文
本地：跑到一半中断，疑似显存不足【环境：本地】
原因：显存不够是最常见的本地生成失败。官方口径有两套，对应不同运行方式：ComfyUI 跑 5B，官方教程说原生 offloading 下 8GB 显存就能跑（docs.comfy.org Wan2.2 教程）；官方仓库脚本跑，同一 5B 单卡至少 24GB（如 RTX 4090），14B 系列单卡命令标注 80GB（GitHub Wan-Video/Wan2.2）。
解决（按顺序降级）：
- 认模板：确认跑的是哪套——搜索名 "Wan2.2 5B" 还是 "Wan2.2 14B I2V" / "Wan2.2 14B FLF2V"；5B 都跑不动，先关掉其他占显存的程序再试
- 降规格：14B 跑不动是常态，官方 FLF2V 模板默认就是较小尺寸（专为低显存设）；把尺寸、帧数各降一档。竖版 720P 的参考口径：TI2V-5B README 标注 704*1280——先跑默认，成了再往大试
- 系统解法：ComfyUI 启动参数一级的降显存手段，去 ComfyUI 显存不足排错
- 还不够：换社区 GGUF 量化版（bullerwins、QuantStack 仓库 + City96/ComfyUI-GGUF 节点，标「社区资源」），操作见 ComfyUI GGUF 量化
💡 「8GB 能跑」和「24GB 起步」打架？
不打架——同一模型在两种运行方式下的口径：ComfyUI 原生 offloading 是一套；官方仓库脚本（generate.py）是另一套，5B 单卡 24GB 那条命令本身就带着 --offload_model True --convert_model_dtype --t5_cpu 三个降显存参数，官方对 OOM（Out-of-Memory）的建议也是加这三个。对号入座，别拿 A 的口径要求 B。
本地：生成慢到怀疑卡死【环境：本地】
原因：视频生成本来就慢，先对官方口径再决定动不动手——TI2V-5B 无专门优化时，单张消费级 GPU 9 分钟内生成 5 秒 720P（GitHub Wan-Video/Wan2.2 的速度声明）。
解决：
- 拿官方口径当尺子：5B 跑 5 秒 720P，9 分钟量级内都算正常，别中途杀进程
- 远超这个量级：不是等的问题——回上一条降规格（尺寸、帧数各降一档再试）
- 进度完全不动、控制台无输出：记下现象，带报错原文去 ComfyUI 排错总览
工作流节点缺失或报红【环境：本地 / 云端】
原因：官方教程把核心节点缺失归为两条：ComfyUI 版本不是最新（Nightly）；启动时有节点导入失败。云端另有一条：Comfy Cloud 要等 ComfyUI 稳定版发布后才跟进更新，新核心节点没上稳定版时就找不到（docs.comfy.org Wan2.2 教程）。
解决：
- 本地：更新 ComfyUI 到最新版；重启后看服务端控制台有没有节点导入失败的提示
- 云端：确认不是新节点没上稳定版——等下一个稳定版
- 红节点、模型加载的具体报错：按报错原文去 ComfyUI 排错总览，节点与模型各有专页
跑出来不对：生成结果崩坏、角色不对、动作不符
视频出来了但不能用，先对表分类（分诊表为本课程设计；内容问题与云端本地无关，以下各条均标【环境：通用】）：
| 症状 | 一句话病因 | 第一刀切哪 |
|---|---|---|
| 画面崩坏：肢体扭曲、脸糊、物体长在一起 | 一次让模型干太多事，或主体太小 | 给动作做减法 |
| 角色不对：脸漂了、像换了个人 | 锚没钉住：首帧图先错了 | 先查图，再查提示词 |
| 动作不符：不按提示词动、自己加戏 | 动词不具体，或提示词和首帧打架 | 换动词、拆任务 |
画面崩坏：肢体扭曲、脸糊成一团【环境：通用】
原因：多数不是模型坏了，是任务太难——一个镜头塞了太多动作，或主体在画面里太小。06 镜老陈的全景摔倒就是重灾区：人小、动作大、雨丝干扰多。
解决：
- 单镜任务行做减法：只写一次连续运动（「脚下一滑身体前倾，摔坐进水洼」），转圈、回头、慢动作这些加戏全删——动词从 4.2 挑
- 先自查首帧图：图本身就崩（六指、糊脸）就回 3.2 参考图 重生图——改图免费，别烧生成
- 主体太小就换景别：全景崩脸改中景近景再生成，全景信息留给相邻镜头补
- 参考图按「光照均匀、表情中性」重备（Runway Gen-4 帮助页对参考图输入的建议，课程借用作通用标准）
角色不对：脸漂了，像换了个人【环境：通用】
原因：锚没钉住。图生视频的锚是首帧图——首帧里的人就不是老陈，出来当然不是；或者首帧对、提示词的固定描述段没贴，模型自由发挥。
解决：
- 先查首帧图：对照 3.1 角色卡 的固定描述段一样样对——方脸、短黑发、黄色骑手马甲；图不对回 3.2 重生图
- 再查提示词：固定描述段整段照贴（3.4 四段公式），别只写「一个外卖骑手」
- 跨镜脸漂用续帧救：把上一镜成片的尾帧截图当这一镜首帧（3.2 的「从上一镜尾帧续」），人物状态顺着剪辑点带过来
- 底线先立好：本课程不承诺人物绝对一致——参考图加固定描述是缓解手段，不是保证
动作不符：不按提示词动，或自己加戏【环境：通用】
原因：动词不具体（「情绪崩溃」画不出来）、一个镜头塞了三件事，或提示词和首帧打架——首帧他站着，提示词写奔跑。
解决：
- 动词换成拍得出来的：一次只写一件事，主谓宾齐全（4.2 的动词用法）
- 提示词和首帧对质：首帧是起点，提示词写从起点出发的运动，别让模型先脑补怎么走到起点
- 借鉴官方提示词扩写机制：Wan2.2 官方仓库推荐生成前扩写提示词——脚本的开关是 --use_prompt_extend，扩写模型 T2V 用 Dashscope 的 qwen-plus、I2V 用 qwen-vl-max，或本地 Qwen（--prompt_extend_target_lang 'zh' 可指定中文）；官方 ComfyUI 教程的工作流没提这个机制，思路可以搬——生成前用任意 LLM 把单镜任务行扩写完整，再粘进工作流
- 改完重试，计数照走：3 次封顶
首尾帧镜头：两头和传的图对不上【环境：通用】
原因：首尾帧工作流的两头是你传的两张图——传反了镜头倒着走，帧图不同源中段再顺也白搭。
解决：回 4.3 的验收三查：片头对首帧、片尾对尾帧各查一次；两头都对、中段怪，才是提示词的事。传图认节点标签，别认示例图。
还是不行？
- 先归档再提问：失败版本按 3.5 命名规范 留着，顺手把这镜记进 1.4 成本表——症状、改了什么、结果，一行就够
- 本地用户：带完整报错原文去 ComfyUI 排错总览 按原文对号；显存类去 显存不足专页；仍不行，带齐下面的清单去 ComfyUI 官方仓库 Issues
- 云端用户：本课程未核验各云端平台的报错文档——查阅所用平台文档或联系平台支持，别拿本地 ComfyUI 的解法硬套云端
- 内容问题反复不过：这镜可能就是难产——去 4.5 重试与替换策略，那里有降级路线和「放过它」的判断标准
提问前备齐五样（谁看了都能复现你的问题）：
| 要带什么 | 例子 |
|---|---|
| 环境与硬件 | 云端：平台名 + 模板名；本地：显卡型号与显存 |
| 工作流 | 模板库搜索名，如 "Wan2.2 14B FLF2V" |
| 报错原文 | 本地：服务端控制台整段复制；云端：平台报错提示截图 |
| 提示词全文 | 整段贴，别只贴单镜任务行 |
| 已试过什么 | 改了哪个变量、重试几次、每次结果 |
检查点 ✅
- 60 秒分诊说得出：跑不出来是环境层，跑出来不对是内容层，各查什么
- 云端与本地各自的起点说得出：任务状态 / 服务端控制台报错原文
- 三类内容问题各知道第一刀：崩坏做减法、角色不对先查图、动作不符换动词
- 本地显存降级路线背得出：认模板 → 降尺寸帧数 → 系统参数 → 社区量化版（标「社区资源」）
- 诊断守三律：一次一个变量、改前归档、3 次封顶
本课小结
✅ 镜头失败诊断这一页，把 AI 视频生成失败从玄学变成流程：
- 先分层：跑不出来是环境层（云端查任务状态、本地查控制台与显存），跑出来不对是内容层（三类分诊）
- 环境层按环境查：云端失败以「查阅平台文档 / 联系支持」收尾；本地显存不够按降级路线走，两套显存口径别混
- 内容层三刀：崩坏做减法、角色不对先查首帧图、动作不符换具体动词；首尾帧镜头另查两头
- 诊断三律：一次一个变量、改前归档（3.5）、重试 3 次封顶（4.5）
关键口径回顾：
| 事项 | 口径 | 出处 |
|---|---|---|
| ComfyUI 跑 5B | 原生 offloading 下 8GB 显存可跑 | ComfyUI 官方教程 |
| 官方仓库脚本跑 5B | 单卡至少 24GB（如 RTX 4090） | Wan2.2 官方 README |
| 14B 系列 | 单卡命令标注 80GB | Wan2.2 官方 README |
| 5B 速度尺子 | 无专门优化，单张消费级 GPU 9 分钟内出 5 秒 720P | Wan2.2 官方 README |
| 低显存备选 | 社区 GGUF 量化版（bullerwins / QuantStack + City96 节点） | 官方教程「社区资源」节，标「社区资源」 |
下一课预告
病根找到了，下一课解决「接下来怎么办」：4.5 镜头重试与替换策略：每镜最多 3 次。
你会学到：
- 重试上限怎么算：每镜 3 次从哪次起算
- 降级路线怎么走：换提示词、换首帧、换工作流，还是放过它
- 失败成本怎么记：回填 1.4 成本表，下一部片子少交学费
相关教程
- ComfyUI 排错总览——本地报错按原文对号入座，节点、模型、显存各有专页
- ComfyUI 显存不足与卡顿——OOM 的系统解法：启动参数一级的降显存手段
- 镜头重试与替换策略——诊断之后的下一步：每镜 3 次上限、降级路线与成本回填