一、日志基础：FFmpeg日志系统架构与级别详解

做转码调优，第一件事不是看参数，而是学会看日志。我见过太多人上来就甩一条长命令，跑完盯着「No such file or directory」发呆——其实日志里早就告诉你了。今天我们就从根上把FFmpeg的日志系统拆开看看。

1.1 FFmpeg日志系统架构

FFmpeg的日志系统，说白了就是一个分级过滤+回调分发的框架。核心代码在libavutil/log.c里，整个架构就三层：

• 生产者：各个模块（libavformat、libavcodec等）调用av_log()输出日志
• 过滤器：根据设置的日志级别决定哪些消息能通过
• 消费者：默认输出到stderr，也可以注册自定义回调

嗯，这里要注意：av_log()是FFmpeg内部唯一的日志出口。你看到的每一行[mov,mp4 @ 0x7f...]，都是它吐出来的。

我个人习惯把日志系统想象成一个漏斗——顶部是海量的trace消息，底部只有最严重的panic。你设置的级别就是漏斗的筛孔大小。

1.2 日志级别详解

FFmpeg定义了9个日志级别，从AV_LOG_QUIET到AV_LOG_TRACE。数字越小越严重，数字越大越啰嗦。我整理了一张表，建议你收藏：

级别常量	数值	命令行参数	含义	典型场景
AV_LOG_QUIET	-8	-loglevel quiet	完全静默	生产环境脚本，只关心退出码
AV_LOG_PANIC	0	-loglevel panic	致命崩溃	进程即将abort，几乎不用
AV_LOG_FATAL	8	-loglevel fatal	不可恢复错误	解码器初始化失败
AV_LOG_ERROR	16	-loglevel error	一般错误	文件找不到、格式不支持
AV_LOG_WARNING	24	-loglevel warning	警告	非关键问题，但值得关注
AV_LOG_INFO	32	-loglevel info	常规信息	默认级别，转码进度、流信息
AV_LOG_VERBOSE	40	-loglevel verbose	详细信息	编解码参数、帧类型决策
AV_LOG_DEBUG	48	-loglevel debug	调试信息	开发阶段，看每个包的pts/dts
AV_LOG_TRACE	56	-loglevel trace	最详细跟踪	逐函数调用，刷屏警告

1.3 日志输出格式解析

一条典型的FFmpeg日志长这样：

[h264 @ 0x7f8a4b800000] [error] mb_type 25 in P slice too large at 23 12

拆开来看，一共四个部分：

1. 模块标识：[h264] —— 哪个组件输出的。常见的有mov,mp4、aac、avformat、swscaler等
2. 上下文地址：@ 0x7f8a4b800000 —— 内存中的实例指针。多路流时靠它区分是哪个实例
3. 级别标签：[error] —— 对应上面的级别。注意这里是小写
4. 消息体：mb_type 25 in P slice too large at 23 12 —— 具体描述

为什么会这样设计？你想想看，FFmpeg经常同时处理多个输入流，每个流有自己的解码器实例。没有上下文地址，你根本分不清是哪个视频轨出了问题。

1.4 如何设置日志级别

命令行里用-loglevel或缩写-v：

# 只显示错误
ffmpeg -i input.mp4 -loglevel error output.mp4

# 显示调试信息
ffmpeg -i input.mp4 -v debug output.mp4

# 完全静默（但保留退出码）
ffmpeg -i input.mp4 -v quiet output.mp4

代码里用av_log_set_level()：

#include <libavutil/log.h>

int main() {
    // 设置级别为 warning 及以上
    av_log_set_level(AV_LOG_WARNING);

    // 注册自定义回调
    av_log_set_callback([](void* ptr, int level, const char* fmt, va_list vl) {
        if (level > av_log_get_level()) return;
        // 你的处理逻辑，比如写入文件
        vfprintf(log_file, fmt, vl);
    });

    // ... 后续转码逻辑
}

1.5 日志级别的选择策略

不同场景该用哪个级别？我列了个清单：

• 线上生产环境：error或quiet。日志太多会拖慢I/O，而且没人看
• 日常测试：warning。既能发现潜在问题，又不会刷屏
• 开发调试：debug。看帧级别信息，比如pts是否连续、dts是否单调递增
• 协议分析：trace。看RTMP/HTTP的每个数据包交互，但慎用

嗯，这里要特别提醒：panic级别几乎不会出现。它只在FFmpeg内部检测到不可恢复的内存损坏时才会触发，触发后直接abort。我做了这么多年，只见过两次——一次是堆溢出，一次是野指针。普通用户基本遇不到。