解决移动端播放MP4黑屏问题，PC端正常的问题
现象
| 现象 | 高概率根因 | 典型解释 |
|---|---|---|
| 前几秒只有音轨；拖动后依旧黑屏、进度条继续走 | MP4 的 moov 原子在文件尾部，移动端播放器拿不到视频关键帧与索引 | 播放器先解出音轨（音频帧通常在前），随后需要到 moov 定位视频帧；但你开启了 Range 分段，第二次请求并未覆盖 moov，于是一直等而不播 |
| 只有部分机型/浏览器黑屏 | 编码 H.265/VP9、过高 Level、10bit → 软解失败 | iOS ≤ 15、安卓多数 WebView 仅硬解 H.264 baseline/main/high ≤ level 4.2 |
| 拖动后每次黑屏 + 服务端日志出现大量 206 Range | Range 逻辑 OK，但Content-Length / Content-Range 计算错误导致解码器丢帧 | 某些机型对字节范围极其敏感，出错就放弃该段 |
绝大多数“有声无画”都能通过 fast-start（移动
moov）、保证 H.264 Baseline 一次性修复。
快速诊断 3 步
-
查看
moov位置ffprobe -v quiet -print_format json -show_format -show_streams demo.mp4 | jq '.format.tags' # 也可用 mp4box -info demo.mp4moov位于文件末端 ⇒ 必须做 fast-start。
-
确认编码兼容
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,profile,level,width,height demo.mp4- 若
codec_name=hevc/vp9或profile=High 4:4:4/level>4.2⇒ 转码为 H.264 Baseline/Main。
- 若
-
抓 Network (Chrome DevTools → Network → Media)
- 第一次 GET 是否 200 OK 或 206 bytes=0-
- 拖动后 Range 是否 bytes=n-m 且
Content-Range、Content-Length正确 - 若返回 200 而不是 206 ⇒ 客户端可能放弃继续解析。
对症下药
1 · Fast-start（把 moov 移到文件头）
ffmpeg -i input.mp4 -movflags +faststart -c copy output.mp4
# 或 MP4Box -inter 500 input.mp4 -out output.mp4
上传到 MinIO 的就用 output.mp4；无需重新编码，耗时≈秒级。
2 · 保证编码兼容移动端
ffmpeg -i input.mp4 \-c:v libx264 -profile:v baseline -level 3.2 -pix_fmt yuv420p \-c:a aac -b:a 128k \output.mp4
原则：H.264 Baseline/Main，高≤1080 p，Level≤4.2，8-bit YUV420，AAC 音频。
3 · 校正 Range 响应
| 必须 Header | 正确写法 |
|---|---|
Accept-Ranges | bytes |
Content-Range | bytes <start>-<end>/<full> （仅 206 时） |
Content-Length | end−start+1 |
| 状态码 | 206（有 Range） / 200（无 Range） |
若第一次就发 200 + 全文件，移动端也能播；但依旧建议让浏览器自己用 206。
检查清单
- MP4 已 fast-start（
moov在前） - 视频编码 H.264 Baseline/Main/High ≤ level 4.2，YUV420 8-bit
- 音频 AAC / MP3 ≤ 48 kHz
- 服务端 Range 头 字节范围与长度一致
- 两次拖动请求都返回 206（或首包 200、后续 206）
- 在 PC Chrome DevTools > Media 能看到 Frames/GOP 正常递增
- 若走 Nginx / CDN 已加
proxy_set_header Range $http_range;并slice/byte-range模式
满足以上条件，移动端 H5 播放器即可全程图像 + 声音正常，拖动也秒级定位。
FFmpeg 下载与安装
Windows、macOS、Linux 常用平台的 FFmpeg 下载与安装 全流程（含验证方法），任选与你开发机匹配的方案即可。示例指令全部在终端 / PowerShell 中执行；如无特殊说明，命令前的 $ 只是提示符，不需要输入。
1. Windows 10/11
1.1 下载
-
打开 https://www.gyan.dev/ffmpeg/builds/
-
在 “Release builds” 区选择：
- ffmpeg-release-essentials.zip（纯工具链；体积小）
- 如需全功能（含所有编码器）选
full版
-
解压到本地，例如
C:\ffmpeg：
C:\ffmpeg└── bin├── ffmpeg.exe├── ffprobe.exe└── ffplay.exe
1.2 配置环境变量
-
Win + Pause → 高级系统设置 → 环境变量
-
在 “系统变量” 找到 Path → 编辑 → 新增一行
C:\ffmpeg\bin -
点 “确定” 直至关闭所有窗口。
1.3 验证
PS> ffmpeg -version
ffmpeg version 7.x … （看到版本号说明成功）
2. macOS (Intel / Apple Silicon)
macOS 最方便的方式就是 Homebrew，自动处理依赖、后续也能一键升级。
$ brew install ffmpeg # 默认带常用编解码器
# 需要额外功能可加参数，例如：
# brew install ffmpeg --with-opencl --with-sdl2
$ ffmpeg -version
若你没有 Homebrew，可从 https://evermeet.cx/ffmpeg/ 下载打包好的 .zip，解压后将 ffmpeg、ffprobe 放到 /usr/local/bin 或 $HOME/bin，记得 chmod +x.
3. Debian / Ubuntu / WSL
$ sudo apt update
$ sudo apt install ffmpeg
$ ffmpeg -version
官方源通常不是最新版；想用最新 release，可添加 deb-multimedia 或使用
snap install ffmpeg.
4. CentOS / Rocky / Alma / Fedora
# RHEL/CentOS 8+
$ sudo dnf install epel-release
$ sudo dnf install ffmpeg ffmpeg-devel# Fedora
$ sudo dnf install ffmpeg
5. Arch / Manjaro
$ sudo pacman -S ffmpeg
6. Docker（无需本地安装）
$ docker run --rm -v $(pwd):/work -w /work jrottenberg/ffmpeg:7-slim \-i input.mp4 -movflags +faststart -c copy output.mp4
- 把当前目录挂到容器
/work，方便读写文件 - 镜像已内置 ffmpeg 7.x，免配置
7. 常用验证与排错
| 目的 | 命令 | |
|---|---|---|
| 查看编解码器列表 | ffmpeg -codecs | head | |
| 查看硬件加速支持 | ffmpeg -hwaccels | |
| 测试转码 | ffmpeg -i input.mp4 -t 3 test.gif | |
检查 moov 是否在文件头 | ffprobe -v error -show_entries format=start_time,duration -i video.mp4若首帧时间远大于 0，或用 `mp4dump video.mp4 | head看moov` 位置 |
小结
- Windows：下载 zip → 解压
C:\ffmpeg→ 添加到 Path。 - macOS：
brew install ffmpeg最省事。 - Linux：用包管理器安装；若版本过旧，可用 Snap、PPA 或编译。
- 一行验证
ffmpeg -version即可确认安装成功。
安装成功后，你就可以运行：
ffmpeg -i input.mp4 -movflags +faststart -c copy output.mp4