
FFmpeg 默认输出为人类可读日志,不便于程序解析;使用 -progress 参数可将进度与结果以 key=value 格式实时输出到文件、TCP 或 HTTP 端点,实现可靠、可编程的状态判断。
ffmpeg 默认输出为人类可读日志,不便于程序解析;使用 `-progress` 参数可将进度与结果以 key=value 格式实时输出到文件、tcp 或 http 端点,实现可靠、可编程的状态判断。
在 Go 等编程语言中调用 FFmpeg 进行视频转码时,仅依赖标准输出(stdout/stderr)或文件存在性判断转换是否成功,存在明显缺陷:
- FFmpeg 的日志格式非结构化,且随版本变化,正则匹配易失效;
- 即使命令退出码为 0,也不代表媒体文件真正可用(如编码中途崩溃但进程未异常退出);
- 单纯检查输出文件是否存在不可靠——文件可能被提前创建但写入不完整,或权限/磁盘空间问题导致静默截断。
推荐方案:使用 -progress 获取机器可读状态流
FFmpeg 自 3.1+ 版本起支持 -progress url 参数,可将结构化进度信息(每秒更新)以纯文本 key=value 形式发送至指定目标。关键特性包括:
- ✅ 每行一个键值对,格式严格、无空格歧义(如
frame=1234,out_time_ms=123456789); - ✅ 最终必定输出
progress=end表示正常结束(失败时通常不输出该行,或输出progress=abort); - ✅ 支持多种后端:本地文件(
-progress progress.log)、TCP socket(-progress tcp://127.0.0.1:8910)、HTTP POST(-progress http://localhost:8080/ffmpeg)。
✅ Go 中安全集成示例
package main
import (
"io"
"log"
"os/exec"
"strings"
)
func isFFmpegSuccess(cmd *exec.Cmd) bool {
// 启动 FFmpeg 并重定向 progress 到管道
pr, pw := io.Pipe()
cmd.ExtraFiles = []*os.File{pw}
cmd.SysProcAttr = &syscall.SysProcAttr{
Setpgid: true,
}
// 实际更推荐:使用 -progress file.txt + 定期轮询文件末尾,或启动本地 TCP listener
// 此处为简化示意,生产环境建议用文件或 TCP 方式避免竞态
}
// 推荐生产实践:写入临时文件并监控 progress=end
func convertWithProgress(source, dest string) error {
progressFile := "/tmp/ffmpeg-progress-" + randString(8) + ".txt"
cmd := exec.Command("ffmpeg",
"-y", // 覆盖输出,避免交互提示
"-i", source,
"-vcodec", "libx264",
"-acodec", "aac",
"-strict", "experimental",
"-progress", progressFile,
dest,
)
output, err := cmd.CombinedOutput()
if err != nil {
log.Printf("FFmpeg command failed: %v, output: %s", err, output)
return err
}
// 检查 progress 文件是否包含 'progress=end'
data, _ := os.ReadFile(progressFile)
if !strings.Contains(string(data), "progress=end") {
return fmt.Errorf("ffmpeg did not complete successfully (missing 'progress=end')")
}
// (可选)进一步验证输出文件有效性
if _, err := os.Stat(dest); os.IsNotExist(err) {
return fmt.Errorf("output file %s was not created", dest)
}
return nil
}⚠️ 注意事项
-
-progress不替代退出码检查:仍需cmd.Run()或cmd.Wait()获取err,因为progress=end仅表示 FFmpeg 主流程结束,不保证系统级成功(如磁盘满导致写入失败后崩溃); - 避免使用
-progress pipe:1直连 stdout —— 会与-v quiet冲突,且难以区分日志与进度流; -
progress=continue表示进行中,progress=end表示成功完成,progress=abort表示异常终止(部分旧版本可能无此字段); - 若需实时响应(如 Web API 进度条),建议搭配 TCP listener(Go 启一个
net.Listen("tcp", ":8910")),按行解析key=value流。
综上,-progress 是 FFmpeg 官方提供的、稳定可靠的机器可读接口,应作为自动化集成的首选方案,而非依赖脆弱的日志解析或文件存在性判断。

















