编码与格式 / 系统课时

解读运行日志

解读运行日志

FFmpeg 的日志不是一串无关的终端文字,而是一份按执行顺序展开的诊断记录。本课将用一次短时解码任务,定位输入探测、流映射、进度统计、警告与错误,让你能快速判断任务卡在哪里。

学习目标

  • 识别日志中的输入信息、流映射和运行进度
  • 区分普通提示、可继续警告与导致退出的错误
  • 按固定顺序从首个异常定位根因

一条日志的五个区域

FFmpeg 通常先打印版本与构建信息,再探测输入容器和媒体流。随后出现 Stream mapping,说明哪些输入流会进入哪些输出流,以及采用复制、解码还是重新编码。任务运行后会持续输出进度,结束时再汇总媒体大小、复用开销或退出原因。

日志级别常见为 info、warning、error 和 fatal。默认输出里不一定显式写出级别名称,因此判断时应结合位置与措辞:输入流信息属于正常提示,Non-monotonous DTS 多为时间戳警告,Invalid data found 或 Conversion failed 通常表示任务失败。

运行一个可控示例

下面的命令只解码输入文件前 3 秒,并把结果交给空输出器,不生成媒体文件。它适合观察日志结构,也能验证输入是否可读取。

bash
ffmpeg -hide_banner -i input.mp4 -t 3 -f null -

预期输出(仅保留关键结构,实际容器、编码器、时间和数值会不同):

text
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>KiB

Input #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。调试日志可能包含文件路径、请求地址或请求头,提交到工单前应先脱敏。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

解读运行日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通