视频导出问题排查：失败、花屏、文件打不开

排查路径：按环节二分

导出问题先二分定位：生成环节的素材就有问题（某切片花屏/黑帧），还是合成导出环节的问题（素材全好，成片坏）？用 ffprobe/播放器逐个检查切片即可区分——切片制的优势是粒度小，定位到具体切片后只重跑那一片。

高频问题对号

导出失败：磁盘空间不足（最常见，导出需要临时空间）；存储目录权限变化（升级或迁移后）；任务队列中断（worker 重启导致任务中断，重跑即可）。

播放花屏/绿屏：像素格式不兼容（部分播放器不支持 yuv444/10bit）——导出参数用 yuv420p；或某切片编码损坏混入拼接，ffprobe 找到它。

文件打不开/只有声音：moov atom 在文件尾（下载未完成即播放会黑屏）——导出时启用 faststart；或浏览器缓存了半个文件，清缓存重下。

文件体积异常大：码率设置过高或同一内容重复编码（多次转码会膨胀）；对照正常成片的码率基线调整。

特定平台上传后异常：平台对编码参数有白名单（如抖音对 H.264 profile、音频采样率的要求），用平台推荐的导出参数模板；上传失败先查平台的状态页与文件大小上限。

预防胜于排查

三个习惯避免九成导出问题：磁盘水位进每周例行（见数据库维护的十分钟例行）；导出后抽一个切片验证能播放再批量发；重要成片在导出后立即进备份（storage 到 OSS），导出产物不是备份。