用 exec.Command 调用 ffmpeg 提取视频元信息需注意:确保 ffmpeg 在 PATH 中;加 -v quiet -print_format json -show_entries 控制输出;正确解析带点字段的 JSON;设置超时并 kill 子进程;Windows 下路径直接传入无需引号,但需处理编码和反斜杠。

用 exec.Command 调用 ffmpeg 提取视频时长、分辨率等元信息
直接调用 ffmpeg 命令是最轻量、最可靠的方式——Go 自身不内置视频解析能力,硬啃 MP4/AVI 容器结构得不偿失。关键不是“能不能”,而是命令怎么拼、输出怎么收、错误怎么判。
常见错误现象:exec: "ffmpeg": executable file not found in $PATH(没装 ffmpeg 或不在 PATH);exit status 1 却没打印 stderr(忽略错误流);输出里混着进度条和警告(没加 -v quiet)。
- 必须用
-v quiet -print_format json -show_entries控制输出格式,避免解析非结构化文本 - 推荐加
-sexagesimal会把时长转成00:01:23.456格式,但 JSON 模式下它无效,得用-show_entries format=duration+ 自己转秒 - 如果只要基础信息(时长、宽高、码率),用
format和streams就够了,别-show_entries stream=all—— 输出爆炸且慢
解析 ffmpeg 的 JSON 输出到 Go struct
ffmpeg 的 -print_format json 输出是合法 JSON,但字段名带点(如 streams.0.width),标准 json.Unmarshal 不认。不能靠字符串切分,也不能手动写 map[string]interface{} 嵌套解析。
正确做法是:先定义结构体,用 json:"streams" 对应顶层 key,再嵌套 slice 或 struct。注意 streams 是数组,哪怕只有一路视频流。
初始化并管理阿里云SDK Go 客户端,涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记(深入)”;
type FFProbeResult struct {
Format struct {
Duration string `json:"duration"`
BitRate string `json:"bit_rate"`
} `json:"format"`
Streams []struct {
CodecType string `json:"codec_type"`
Width int `json:"width"`
Height int `json:"height"`
} `json:"streams"`
}
- Duration 是字符串(单位秒,含小数),不是 float64——ffmpeg 输出带精度,比如
"123.456000",直接转 float 可能丢精度,建议用strconv.ParseFloat按需处理 - 如果视频没有视频流(只有音频),
Width/Height字段不会出现,struct 字段要设默认零值或用指针*int配合omitempty - 别用
map[string]interface{}解析——类型丢失、易 panic、无法静态检查
超时控制和子进程僵死问题
ffmpeg 分析大文件(尤其高清 MKV)可能卡住,Go 默认不设超时,cmd.Run() 会一直挂起。更糟的是,如果父进程崩溃而 ffmpeg 还在跑,它就成孤儿进程继续吃 CPU。
- 必须用
context.WithTimeout包裹cmd.Start()和cmd.Wait(),超时后调用cmd.Process.Kill() - 别只依赖
cmd.Run()的 timeout——它只管启动阶段,实际执行中卡死仍无响应 - Windows 下
Kill()可能不彻底,加个defer os.RemoveAll(tempDir)清理临时文件(如果用了-i重定向输入) - 用
cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}(Linux/macOS)可确保 kill 时连同子进程一起干掉
Windows 下路径空格和编码问题
用户传入的视频路径含中文或空格(如 C:我的视频 est.mp4),直接拼进 exec.Command("ffmpeg", "-i", path, ...) 会失败——Windows cmd 解析参数时把空格当分隔符,ffmpeg 收到的路径被截断。
- 不用自己加引号!
exec.Command参数是字符串切片,每个元素独立传递,操作系统不走 shell 解析,所以exec.Command("ffmpeg", "-i", "C:\我的视频\test.mp4")安全 - 但 Windows 控制台默认 GBK 编码,ffmpeg stderr 输出中文(如“无法打开”)会乱码;解决方案:改用
chcp 65001切 UTF-8,或干脆忽略 stderr 中文内容,只信 JSON stdout - 路径不要用正斜杠
/混用(虽然 Go runtime 通常兼容),统一用双反斜杠\或 raw string`C:myideo.mp4`
真正麻烦的是容器格式异常、损坏文件、ffmpeg 版本差异导致字段缺失——这些没法靠代码兜底,得靠日志记录原始 ffmpeg 输出,方便回溯。

















