ffmpeg 9.0 升级后水印命令异常,主因是滤镜图调度、帧内存模型(avbufferref引用计数)和时间基处理的底层重构;overlay报错、绿屏、偏移或卡死均源于新约束对老写法的严格校验。

直接换 ffmpeg 9.0 二进制或链接库后,原来能跑通的水印命令(比如带 overlay 的滤镜链)突然报错、绿屏、偏移错位,甚至卡死——这不是你参数写错了,而是 9.0 对滤镜图调度、帧内存模型和时间基处理做了底层重构,老写法踩到了新约束。
overlay 滤镜报 “Invalid data found when processing input” 或直接退出
这是最典型的信号:9.0 强制校验输入帧的完整性,不再容忍解码失败后“硬塞”一帧进滤镜图。老项目常依赖 FFmpeg 6.x 的容错行为(比如跳过损坏帧、用前一帧补),而 9.0 默认开启 AV_FRAME_FLAG_CORRUPT 标志检测,并在 av_buffersink_get_frame() 阶段直接拒绝。
- 加
-fflags +discardcorrupt让解封装层主动丢弃已知损坏包(适用于源文件本身有轻微 CRC 错误) - 在
filter_complex开头加[0:v]settb=AVTB, setpts=N/FRAME_RATE/TB显式重置时间基,避免老命令中隐式 timebase 换算失效 - 如果水印图是 PNG,确认它不含 alpha 通道异常(如全透明区域被错误标记为不透明),可用
ffprobe -v quiet -show_entries stream=codec_name,pix_fmt -of default watermark.png查看pix_fmt是否为rgba;若不是,先用ffmpeg -i watermark.png -vf format=rgba watermark_rgba.png转一次
水印位置偏移、缩放失真或右下角坐标计算失效
9.0 的 overlay 滤镜内部改用更严格的像素对齐检查,且 W/H/w/h 变量现在严格绑定到当前帧的 AVFrame.width/height,不再回退到容器头里的 width 字段。这意味着:如果视频流含旋转元数据(如手机竖拍 MP4 的 rotate=90),老命令里直接用 W-w-10 就会算错——因为 W 是原始解码宽(比如 720),但实际显示宽是 1280。
- 统一前置
transpose或rotate滤镜把方向归一化,例如:-vf "transpose=2,overlay=W-w-10:H-h-10"(transpose=2表示顺时针90°) - 改用
overlay=x='if(gte(iw,ih),W-w-10,10)':y='if(gte(iw,ih),H-h-10,10)'这类运行时条件表达式,避免静态变量误判 - 禁用自动旋转:加
-noautorotate参数,让所有旋转由滤镜显式控制,防止libavformat在解封装阶段偷偷改AVStream.codecpar->width
加完水印后音频不同步、首帧黑场或耗时暴涨
这往往不是 overlay 本身的问题,而是 9.0 的多流水线背压机制生效了。老项目常用单线程同步调用模式,而 9.0 默认启用异步解码与滤镜调度,若未正确配置缓冲区大小或帧所有权释放,会导致音视频帧在队列中堆积、阻塞、超时重试。
- 强制关闭异步解码:加
-threads 1 -async 1(-async 1表示音频重采样时强制同步对齐) - 限制滤镜图缓冲深度:在
filter_complex后加fifo滤镜并设max_bufs=32,例如:"[0:v][1:v]overlay=W-w-10:H-h-10,fifo=max_bufs=32" - 若使用硬件加速(如
-hwaccel cuda),必须显式指定-hwframes 16,否则 9.0 不再自动推导,容易因 GPU 帧池不足导致死锁
为什么简单加 -v quiet 或删日志还解决不了问题
因为 9.0 的关键变化不在日志级别,而在内存生命周期管理。比如老代码里可能直接修改 frame->data[0] 来做 YUV 填充,这在 6.1 是可行的;但在 9.0,frame->buf[0] 是 AVBufferRef*,任何裸指针写入都会触发 debug build 下的 assert 或 release 下的静默崩溃。水印命令看似只是字符串拼接,背后却牵扯到 AVFrame 分配、引用计数、硬件帧映射三重逻辑。一个 overlay 失效,十有八九是某处帧没被正确 av_frame_free(),或者 av_buffer_pool_get() 返回的 buffer 被提前释放了。











