PHP不直接转码，花屏根源在FFmpeg命令参数或输入源异常；需用ffprobe检查流信息、VLC验证源文件、修复封装，避免GOP与帧率失配，禁用硬件加速先验CPU编码，并用escapeshellarg和proc_open确保命令安全完整。
PHP本身不直接处理视频转码，花屏问题出在FFmpeg命令参数或输入源上，PHP只是调用它。关键不是改PHP代码，而是优化FFmpeg命令和排查源头。
检查输入文件是否损坏或编码异常
很多“花屏”其实是源视频本身就有解码错误、关键帧缺失或封装格式不规范。FFmpeg强行转码会把问题放大。
- 用
ffprobe input.mp4查看流信息，重点关注codec_name、profile、level和是否有警告（如[h264 @ ...] missing picture in access unit） - 尝试用 VLC 播放源文件——如果VLC也卡顿/绿块/跳帧，基本可判定是源问题
- 对可疑源文件先做“修复封装”：
ffmpeg -i broken.mp4 -c copy -movflags +faststart fixed.mp4，再转码
避免强制关键帧间隔与GOP设置冲突
花屏常发生在B帧或P帧参考链断裂时，尤其是设置了 -g（GOP大小）但没配好 -bf（B帧数）或 -vsync。
- 不要盲目加
-g 25，尤其对手机录的HEVC/H.265源；优先让编码器自动决策：-g 0或直接省略 - 若需固定GOP（如直播推流），务必匹配帧率：
-g 50对应 25fps 就是2秒I帧间隔，同时加-keyint_min 50 - 加
-vsync vfr或-vsync cfr明确时间基策略，避免音画不同步引发解码错位
慎用硬件加速与编码器混用
启用 -hwaccel cuda 或 -c:v h264_nvenc 时，若驱动、FFmpeg版本、GPU固件不匹配，极易输出花屏帧（尤其B帧或高分辨率）。
立即学习“PHP免费学习笔记（深入）”；
- 先用纯CPU编码验证：去掉所有
-hwaccel、-c:v xxx_qsv/xxx_nvenc，改用-c:v libx264 - 若CPU版正常，再逐步启用硬件加速，并指定严格参数：
-c:v h264_nvenc -rc vbr -qmin 18 -qmax 28 -b:v 2M，避免默认码率控制失准 - NVIDIA用户注意：
ffmpeg -hwaccels查看是否支持cuda，并确认nvidia-smi能正常调用GPU
PHP调用时确保参数安全与完整
PHP中拼接命令容易漏空格、未转义特殊字符（如路径含空格、&、$），导致FFmpeg实际执行的命令被截断或注入无效参数。
- 用
escapeshellarg()包裹所有路径和参数值：escapeshellarg($inputPath)、escapeshellarg('-vf scale=1280:720') - 不要用
exec()直接吞掉错误输出，至少捕获stderr：exec("ffmpeg -i ... 2>&1", $output, $returnCode)，打印 $output 排查具体报错 - 避免后台运行（
&结尾），PHP可能提前释放资源导致FFmpeg读取中断——用proc_open()更可控
