根本原因是FFmpeg用-vf会触发默认CRF23重编码，导致画质下降；应优先用码率锚定（-b:v）+格式对齐（yuva420p）+escapeshellarg()防注入来保质保安全。
为什么直接用 -vf 加水印后画质明显变差？
根本原因不是水印本身，而是 FFmpeg 默认启用的编码器参数：只要用了 -vf（哪怕只是 overlay），FFmpeg 就会触发重新编码流程，而默认的 libx264 编码器会启用 -crf 23（中等质量）和自动预设（通常是 medium），这会导致画质损失——尤其原视频是高码率、高 CRF（如 CRF 18）时，降级感非常明显。
关键判断：加水印 ≠ 必须重编码。若原视频与水印图尺寸/帧率/色彩空间兼容，且只做简单叠加，完全可以绕过编码，走「流复制 + 帧级覆盖」路径。
实操建议：
- 优先检查源视频编码信息：
ffprobe -v quiet -show_entries stream=codec_name,width,height,r_frame_rate,pix_fmt -of csv=p=0 input.mp4 - 确保水印图是 PNG（带 alpha 通道），尺寸不大于视频宽高，且为无损格式（避免 JPG 水印二次失真）
- 若视频是 H.264 + yuv420p + 25/30fps，水印位置固定，
overlay可配合-c:v copy避免重编码——但注意：copy模式下overlay实际由滤镜链内完成，仍需解码一帧再覆写，所以必须加-c:a copy并禁用音频重编码，否则音频流会触发全局重编码
ffmpeg -i video.mp4 -i watermark.png -filter_complex "overlay=10:10" -c:v libx264 -crf 18 -preset slow -c:a copy output.mp4 还是糊？
问题出在 -crf 18 不等于“保持原画质”。CRF 是相对质量标尺，不同视频内容、分辨率、运动量下，同一 CRF 对应的实际码率差异极大。原视频若本身是 8000kbps 码率，用 CRF 18 编出来可能只有 4000kbps，细节就丢了。
立即学习“PHP免费学习笔记（深入）”；
更可靠的做法是「码率锚定」+「编码参数对齐」：
- 先用
ffprobe提取原视频视频流码率：ffprobe -v quiet -show_entries format=bit_rate -of default=noprint_wrappers=1:nokey=1 input.mp4，假设输出7852341（约 7852 kbps） - 用
-b:v 7852k -maxrate 7852k -bufsize 15704k锚定目标码率（bufsize通常设为 2×码率） - 强制使用与原视频一致的 profile 和 level：
-profile:v high -level 4.1（查原视频用ffprobe -v quiet -show_entries stream=profile,level -of csv=p=0 input.mp4） - 保留原 GOP 结构（关键帧间隔）：
-g 50（若原视频是 25fps、2s 一个 I 帧，则-g 50）
PHP 中调用 FFmpeg 命令时，如何防止 shell 注入又保证路径安全？
直接拼接 exec("ffmpeg -i {$input} ...") 极其危险：用户上传的文件名含空格、分号、$()、反引号都会导致命令逃逸。PHP 的 escapeshellarg() 是唯一靠谱方案，但它只处理单个参数，不能包整个命令。
正确姿势是拆解参数，逐个转义：
- 输入输出路径必须用
escapeshellarg()包裹：$cmd = 'ffmpeg -i ' . escapeshellarg($input_path) . ' -i ' . escapeshellarg($watermark_path) . ' -filter_complex "overlay=10:10" -b:v ' . $target_bitrate . 'k -c:a copy ' . escapeshellarg($output_path); - 滤镜表达式中的坐标值（如
10:10）若来自用户输入，必须强校验为整数：filter_var($x, FILTER_VALIDATE_INT) !== false - 禁止让用户控制编码器选项（如
-preset、-profile:v），这些应由 PHP 后端按视频特征自动决策并固化 - 执行前加超时和内存限制：
exec($cmd . ' 2>&1', $output, $return_code);，并检查$return_code !== 0时读取$output中是否含Error:或Invalid argument
水印边缘发虚、有半透明残影？
这是色彩空间不匹配的典型表现。FFmpeg 滤镜默认工作在 yuv420p，但 PNG 水印是 rgba，直接 overlay 会触发隐式转换，alpha 通道被错误解释，导致边缘混合异常。
解决方法只有一条：显式指定水印输入的像素格式，并在 overlay 前做格式对齐：
- 给水印输入加
-pix_fmt yuva420p（支持 alpha 的 YUV 格式）：-i watermark.png -pix_fmt yuva420p - 在 filter_complex 中强制主视频也转成 yuva420p（或至少统一到 yuv420p）：
"[0:v]format=yuv420p[v0]; [1:v]format=yuva420p[v1]; [v0][v1]overlay=10:10" - 若水印需缩放，务必在 format 之后做 scale，避免缩放后再格式转换放大误差：
[1:v]scale=200:-1,format=yuva420p[v1]
复杂点在于：PHP 调用时，filter_complex 字符串里的双引号、方括号、分号都容易和 shell 解析冲突，必须用单引号包裹整个 filter 字符串，并确保 PHP 变量插值时不破坏结构——最稳妥的是把 filter 写死或通过配置生成，别让用户动态构造。
