FFmpeg报错怎么排查？编码、格式和推流问题解决方案
用 FFmpeg 处理音视频，报错信息常常一句话带过，搜索引擎给你的答案又是"试试这条命令"却不解释原因。这篇文章按错误类型分类，每个问题先说原因再说解决方案。
编码问题
"Error while opening encoder"——编码器不可用
原因：FFmpeg 编译时没包含该编码器，或者编码器名称拼写错了。
# 先确认编码器是否可用 ffmpeg -encoders | grep h264
如果列表里没有 libx264，说明编译时没加 --enable-libx264。解决方案：重新编译 FFmpeg 或安装完整版。Ubuntu 上 sudo apt install ffmpeg 通常包含常用编码器；如果是从源码编译的，需要手动 enable。
检查编码器名称也容易出错：NVIDIA GPU 编码器叫 h264_nvenc 不是 nvenc_h264，Intel QSV 叫 h264_qsv 不是 qsv_h264。
编码速度太慢
原因：默认 preset 是 medium，追求质量但速度一般。
# 优先速度，牺牲一点质量 ffmpeg -i input.mp4 -c:v libx264 -preset veryfast output.mp4 # 极速（质量明显下降，适合预览） ffmpeg -i input.mp4 -c:v libx264 -preset ultrafast output.mp4 # 有 GPU 的话直接用硬件编码 ffmpeg -hwaccel cuda -i input.mp4 -c:v h264_nvenc output.mp4
preset 从快到慢：ultrafast → veryfast → fast → medium → slow → veryslow。越慢质量越好、文件越小，但收益递减——slow 比 medium 慢 2-3 倍但只省 5-10% 体积。一般选 veryfast 或 fast 就够。
音视频不同步
原因通常是三种：源文件本身时间戳不对、编码时帧率设置错误、或者 -async 没处理音频漂移。
# 方案一：强制音频同步（简单粗暴） ffmpeg -i input.mp4 -async 1 output.mp4 # 方案二：重新编码音视频（更可靠） ffmpeg -i input.mp4 -c:v libx264 -c:a aac output.mp4 # 方案三：指定正确帧率 ffmpeg -i input.mp4 -r 25 output.mp4
-async 1 让音频时间戳强制对齐到视频，简单有效但可能引入音频跳变。如果源文件 PTS（Presentation Time Stamp）本身错乱，需要用 -vsync cfr 强制固定帧率。
格式问题
"Unsupported codec"——格式不支持
# 查看 FFmpeg 支持的所有格式 ffmpeg -formats # 查看某格式支持的编码器 ffmpeg -encoders | grep mp4
最常见的场景：MKV 转 MP4 时 MKV 里有字幕流或特殊编码，MP4 容器不支持。解决方案是只保留音视频流：
ffmpeg -i input.mkv -c:v libx264 -c:a aac -map 0:v:0 -map 0:a:0 output.mp4
-map 手动选择要保留的流，忽略字幕等不兼容的。
播放器兼容性差
某些播放器（特别是老款电视、浏览器）对 MP4 的 H.264 profile 和 level 有要求：
# 生成最大兼容性的 MP4 ffmpeg -i input.mp4 -c:v libx264 -profile:v baseline -level 3.0 -c:a aac output.mp4
baseline profile 去掉了 B 帧和高级编码特性，几乎所有设备都能播。代价是同质量下文件更大。加上 -movflags +faststart 让 moov atom 移到文件头部，网页播放不用等下载完：
ffmpeg -i input.mp4 -c:v libx264 -c:a aac -movflags +faststart output.mp4
流媒体问题
RTMP 推流失败
常见原因：网络不通、推流地址格式错误、编码格式不兼容。
# 先确认网络连通 ping rtmp.server.com # 推流时加 -re 按实际帧率发送（否则一口气全推出去，服务器跟不上） ffmpeg -re -i input.mp4 -c copy -f flv rtmp://server/live/stream_key # 加超时避免卡死 ffmpeg -re -i input.mp4 -timeout 5000000 -c copy -f flv rtmp://server/live/stream_key
-re 是推流的关键参数——不加的话 FFmpeg 会以最快速度把所有帧塞过去，服务器和观众端都会缓冲溢出。
HLS 播放卡顿
# 增加分片时长（默认 2 秒太短，改 10 秒减少请求次数） ffmpeg -i input.mp4 -f hls -hls_time 10 output.m3u8 # 缩短 GOP（关键帧间隔），确保每个分片都有关键帧 ffmpeg -i input.mp4 -c:v libx264 -g 25 -f hls -hls_time 10 output.m3u8
-g 25 每 25 帧一个关键帧（25fps 下就是 1 秒一个），确保 HLS 分片边界对齐关键帧，否则切分时会出现花屏。
滤镜问题
"Invalid filterchain"——滤镜语法错误
滤镜语法是 FFmpeg 里最容易出错的部分。简单滤镜用 -vf/-af，复杂滤镜用 -filter_complex：
# 简单滤镜：单个输入 ffmpeg -i input.mp4 -vf "scale=1280:720" output.mp4 # 复杂滤镜：多个输入或需要中间标签 ffmpeg -i input.mp4 -filter_complex "[0:v]scale=1280:720[v]" -map "[v]" output.mp4
常见语法错误：标签没对应（定义了 [v] 但 -map 里写成 [out]）、分号和逗号混用（逗号连接同一链内的滤镜，分号分隔不同链）。
滤镜处理后速度变慢
原因：滤镜是纯 CPU 计算，有些滤镜（如去隔行、缩放）非常吃资源。
# 用 GPU 加速的缩放滤镜（NVIDIA） ffmpeg -hwaccel cuda -i input.mp4 -vf "scale_npp=1280:720" output.mp4 # 优化滤镜顺序：先裁剪再缩放（处理更少的像素） ffmpeg -i input.mp4 -vf "crop=640:480,scale=320:240" output.mp4
调试方法
遇到问题先看详细日志：
# 详细日志（看编码器选择、流信息） ffmpeg -v verbose -i input.mp4 output.mp4 # 调试日志（看每一帧的处理） ffmpeg -v debug -i input.mp4 output.mp4 # 只分析不编码（快速检查输入文件信息） ffmpeg -i input.mp4 -f null -
性能基准测试：
# 测试解码速度 ffmpeg -benchmark -i input.mp4 -f null - # 测试编码速度 ffmpeg -benchmark -i input.mp4 -c:v libx264 -f null -
-benchmark 会输出 utime（用户态耗时）、stime（内核态耗时）、rtime（实际耗时），用来对比不同参数的性能差异。