视频转码后发白的根本原因是色彩空间、色彩范围或传输特性参数未正确设置，需在FFmpeg命令中显式指定colorspace=bt709、color_range=tv、color_trc=bt709，并可添加-no_color_range_detect禁用自动探测，必要时配合zscale滤镜做HDR到SDR色调映射。
PHP 本身不直接处理视频颜色问题，它只是调用 ffmpeg 命令行工具。视频转码后颜色发白（尤其是从 H.265/HEVC 或某些高动态范围源转为 SDR 时），根本原因通常是色彩空间（color space）、色彩范围（color range）或伽马/传输特性（transfer characteristics）参数未正确设置，导致播放器错误解释像素值。
检查并显式指定色彩参数
FFmpeg 默认可能省略或推断错误的色彩属性，尤其在输入流元数据不完整时。务必在命令中明确指定以下三项：
-
colorspace：如
bt709（主流高清标准） -
color_range：SDR 视频通常用
tv（即 limited range，16–235），而非pc（full range，0–255）；误设为pc会导致画面过曝、发白 -
color_trc（transfer characteristic）：如
bt709或srgb，避免默认的smpte2084（HDR）残留
示例命令（PHP 中用 exec() 或 shell_exec() 调用）：
ffmpeg -i input.mp4 -c:v libx264 -colorspace bt709 -color_range tv -color_trc bt709 -c:a aac output.mp4
立即学习“PHP免费学习笔记（深入）”；
禁用自动色彩探测（-no_color_range_detect）
某些 FFmpeg 版本（尤其较新版本）会尝试自动探测色彩范围，但容易出错。添加 -no_color_range_detect 可强制忽略输入中的可疑元数据，完全依赖你手动指定的参数：
ffmpeg -i input.mp4 -no_color_range_detect -c:v libx264 -colorspace bt709 -color_range tv -color_trc bt709 output.mp4
确认输入源的真实色彩属性
先用 FFmpeg 查看原始文件的色彩信息：
ffprobe -v quiet -show_entries stream=color_space,color_range,color_transfer -of default input.mp4
若输出中 color_range=pc 或 color_transfer=smpte2084，说明是 HDR 或 full-range 源，不能直接按普通 SDR 处理。此时需额外做色调映射（tone mapping）或范围压缩，例如：
ffmpeg -i input.mp4 -vf "scale=out_color_matrix=bt709:out_range=tv,zscale=t=linear:npl=100,format=gbrpf32le,zscale=t=bt709:m=bt709:r=tv,format=yuv420p" -c:a copy output.mp4
（该滤镜链将 HDR 线性光转为 SDR，适合进阶场景）
避免容器封装干扰
MP4 容器有时会 store incorrect color metadata even if video data is fine。可用 mp4box 或 FFmpeg 自身重写头信息：
ffmpeg -i output.mp4 -c copy -movflags +write_colr output_fixed.mp4
或更稳妥地，强制清除并重写（适用于已知参数正确的输出）：
ffmpeg -i output.mp4 -c copy -color_primaries bt709 -color_trc bt709 -colorspace bt709 output_clean.mp4
