编码与格式 / 系统课时
解读运行日志
解读运行日志
FFmpeg 的日志不是一串无关的终端文字,而是一份按执行顺序展开的诊断记录。本课将用一次短时解码任务,定位输入探测、流映射、进度统计、警告与错误,让你能快速判断任务卡在哪里。
学习目标
- 识别日志中的输入信息、流映射和运行进度
- 区分普通提示、可继续警告与导致退出的错误
- 按固定顺序从首个异常定位根因
一条日志的五个区域
FFmpeg 通常先打印版本与构建信息,再探测输入容器和媒体流。随后出现 Stream mapping,说明哪些输入流会进入哪些输出流,以及采用复制、解码还是重新编码。任务运行后会持续输出进度,结束时再汇总媒体大小、复用开销或退出原因。
日志级别常见为 info、warning、error 和 fatal。默认输出里不一定显式写出级别名称,因此判断时应结合位置与措辞:输入流信息属于正常提示,Non-monotonous DTS 多为时间戳警告,Invalid data found 或 Conversion failed 通常表示任务失败。
运行一个可控示例
下面的命令只解码输入文件前 3 秒,并把结果交给空输出器,不生成媒体文件。它适合观察日志结构,也能验证输入是否可读取。
ffmpeg -hide_banner -i input.mp4 -t 3 -f null -预期输出(仅保留关键结构,实际容器、编码器、时间和数值会不同):
Input #0, <CONTAINER>, from 'input.mp4':
Duration: <TIME>, start: 0.000000, bitrate: <ID> kb/s
Stream #0:0: Video: <CODEC>, <WIDTH>x<HEIGHT>
Stream #0:1: Audio: <CODEC>, <ID> Hz
Stream mapping:
Stream #0:0 -> #0:0 (<CODEC> -> wrapped_avframe)
Stream #0:1 -> #0:1 (<CODEC> -> pcm_s16le)
frame=<ID> fps=<ID> time=00:00:03.00 speed=<ID>x
video:<ID>KiB audio:<ID>KiBInput #0 表示第一个输入,Stream #0:1 表示输入 0 的流 1。Stream mapping 是最值得先看的部分:如果预期的音频或字幕没有出现在这里,问题通常发生在自动选流或 -map 参数,而不是编码阶段。
解读进度行
进度行中的 frame 是已处理视频帧数,fps 是当前处理速度,time 是输出时间轴位置,speed 是相对实时速度。speed=2.0x 表示约以两倍实时速度处理;若数值长期接近零,应继续检查磁盘、网络输入、滤镜复杂度或硬件编码器是否阻塞。
进度不是严格线性百分比。可变帧率、输入时长未知、复杂滤镜和多路输出都会让 frame 或 time 的增长不均匀。判断任务是否仍在工作,应同时观察时间是否推进、CPU 或 GPU 是否有负载,以及日志是否反复出现同一条重试信息。
按首个异常排查
真正的根因通常出现在 Conversion failed 之前。排查时先从日志顶部向下寻找第一条 error 或明显异常,再检查其前后的输入流、映射和参数上下文,不要只复制最后一行错误。
- 输入探测阶段失败:检查路径、权限、文件完整性与协议访问
- 流映射阶段失败:检查流序号、可选映射和目标封装支持
- 编码初始化失败:检查编码器名称、像素格式、采样率和硬件设备
- 处理中途失败:检查损坏数据、磁盘空间、网络中断和时间戳异常
需要减少噪声时可使用 -loglevel warning,需要定位底层细节时可临时使用 -loglevel debug。调试日志可能包含文件路径、请求地址或请求头,提交到工单前应先脱敏。