编码与格式 / 系统课时
常见异常排查
常见异常排查
音视频异常通常不是单一模块造成的。本课建立一套从输入文件、时间戳、解码、缓冲到输出设备的定位顺序,并分别处理花屏、无声、卡顿、音画不同步和时间戳异常。
学习目标
- 能按固定链路缩小异常范围,避免凭现象直接修改代码
- 能识别画面、声音、卡顿与同步问题的常见根因
- 能使用
ffprobe和ffmpeg完成基础验证与修复确认
建立统一定位顺序
排查时先确认问题能否稳定复现,再判断异常发生在输入、处理链路还是播放端。不要一开始就调整码率、缓冲区或同步阈值,否则可能掩盖真正的时间戳或数据损坏问题。
推荐顺序是:检查封装与流信息,验证数据包时间戳,单独解码视频和音频,检查处理与编码阶段,最后再看网络缓冲和播放器策略。

先用 ffprobe 获取容器、编码、时间基和起始时间。下面的命令可直接执行,文件名按实际样本替换。
ffprobe -v error \
-show_entries format=format_name,duration,start_time \
-show_entries stream=index,codec_type,codec_name,pix_fmt,sample_rate,channels,time_base,start_time,duration \
-of default=noprint_wrappers=1 \
input.mp4预期输出
index=0
codec_name=h264
codec_type=video
pix_fmt=yuv420p
time_base=1/90000
start_time=0.000000
index=1
codec_name=aac
codec_type=audio
sample_rate=48000
channels=2
time_base=1/48000
start_time=0.000000
format_name=mov,mp4,m4a,3gp,3g2,mj2
start_time=0.000000
duration=<TIME><TIME> 会随媒体长度变化。若缺少目标流、起始时间明显异常,或音视频流的持续时间差异很大,应优先检查采集、封装或转码阶段。
花屏与黑屏
花屏通常来自码流损坏、参考帧缺失、关键帧前置数据不完整,或像素格式与内存布局处理错误。黑屏则常见于解码失败后仍输出空帧、颜色范围处理错误,或渲染端没有正确使用图像宽高和行跨度。
定位时先让 ffmpeg 只解码不转码。如果命令行也出现错误,问题多半在输入码流或封装;如果命令行正常而业务程序异常,应检查解码器初始化、SPS/PPS/VPS、像素格式转换、帧缓冲生命周期和线程并发。常见检查点如下:
- H.264/H.265 是否从关键帧开始解码,参数集是否在首个关键帧前可用
width、height、linesize和实际内存大小是否一致- YUV 平面地址、像素格式和颜色范围是否匹配
- 解码后的帧是否在渲染完成前被复用或释放
- 丢包后是否等待新的关键帧再恢复画面
无声与卡顿
无声排查先区分“没有音频流”“解码无输出”和“有 PCM 但未播放”。确认音频流存在后,再检查采样率、声道数、采样格式、声道布局和设备参数是否一致。重采样配置错误时,程序可能不报错,但输出长度为零或声音严重失真。
卡顿要区分网络输入不足、解码速度不足和同步策略主动等待。观察队列长度和各线程耗时:输入队列持续为空,通常是网络抖动或读取阻塞;压缩包堆积而视频帧不足,通常是解码性能问题;音视频队列都有数据但画面仍停顿,则应检查主时钟和等待逻辑。
不要仅通过增大缓冲解决卡顿。缓冲只能吸收短时抖动,无法修复持续带宽不足、解码耗时超过帧间隔或错误的时间戳。
音画不同步与时间戳异常
音画同步依赖统一时钟。解码帧上的 PTS 必须结合所属流的 time_base 转换为秒,不能直接比较整数值。DTS 主要用于解码顺序,存在 B 帧时,DTS 与 PTS 不相等是正常现象。
时间戳异常常见于重新封装时未保留起始偏移、拼接片段未连续累加、采集端时钟回退,以及音频采样数累计方式错误。表现包括首帧等待很久、播放突然加速、越播越不同步或进度条跳变。
修复时应先选择主时钟。实时播放器通常以音频时钟为主,因为音频设备连续输出且不适合频繁跳变;纯视频或无音频场景可使用视频时钟或外部单调时钟。小偏差通过丢帧、重复显示或轻微重采样纠正,大幅跳变则应重置队列和同步基准。
修复后验证
修复完成后必须回到原始样本和原始复现步骤验证,不能只用新生成的正常文件。至少覆盖从头播放、随机拖动、暂停恢复、倍速切换和长时间运行。
对于实时流,还应增加弱网、短时断网、乱序、丢包和服务器重连测试。修复被确认的标准不是“本机看起来正常”,而是日志不再出现连续解码错误、队列不会无限增长、音画偏差稳定在产品允许范围内,并且异常恢复后能够继续播放。