
FFmpeg 默认输出为人类可读日志,不便于程序解析;通过 -progress 参数可将进度与结果以 key=value 格式实时输出到文件、TCP 或 HTTP 端点,实现可靠、可编程的状态判断。
ffmpeg 默认输出为人类可读日志,不便于程序解析;通过 `-progress` 参数可将进度与结果以 key=value 格式实时输出到文件、tcp 或 http 端点,实现可靠、可编程的状态判断。
在 Go 等编程语言中调用 FFmpeg 时,仅依赖标准输出(stdout/stderr)或文件存在性来判断转码是否成功是不可靠的:FFmpeg 可能因编码错误、磁盘满、权限不足等原因中途失败,但仍生成部分输出或临时文件;而其标准日志格式无固定结构,难以稳定解析。真正健壮的方案是利用 FFmpeg 内置的机器可读接口——-progress。
✅ 推荐方案:使用 -progress 获取结构化状态
-progress 参数支持多种输出目标,关键特性如下:
- 每秒自动推送一组
key=value键值对(含帧数、码率、耗时、速度等); -
最终一行必定以
progress=end结尾,表示任务正常完成; - 若进程异常退出(如被 kill、崩溃),则不会输出
progress=end; - 支持输出到:本地文件(
-progress /path/to/log.txt)、TCP 端口(-progress tcp://127.0.0.1:8910)、HTTP POST(-progress http://localhost:3000/ffmpeg)等。
示例:Go 中结合 -progress 实现可靠判断
package main
import (
"io"
"os/exec"
"strings"
)
func isFFmpegSuccess(source, dest string) (bool, error) {
// 创建临时进度文件
progressFile := "/tmp/ffmpeg-progress-" + strings.ReplaceAll(dest, "/", "_")
defer os.Remove(progressFile) // 清理
cmd := exec.Command("ffmpeg",
"-i", source,
"-vcodec", "libx264", // ✅ 建议显式写 libx264 而非 h264(后者是解码器别名)
"-acodec", "aac",
"-strict", "-2",
"-progress", progressFile,
dest,
)
// 捕获 stderr(关键日志和错误仍在此)
output, err := cmd.CombinedOutput()
if err != nil {
return false, err
}
// 读取进度文件,检查是否以 progress=end 结尾
data, _ := os.ReadFile(progressFile)
lines := strings.Split(strings.TrimSpace(string(data)), "\n")
if len(lines) == 0 {
return false, nil // 无进度记录 → 异常
}
lastLine := strings.TrimSpace(lines[len(lines)-1])
if lastLine == "progress=end" {
return true, nil
}
// 可选:进一步检查 stderr 中是否有 ERROR 关键字增强鲁棒性
if strings.Contains(string(output), "Error") || strings.Contains(string(output), "error=") {
return false, nil
}
return false, nil
}
⚠️ 注意事项:
- 避免仅依赖
os.Stat(dest).Exists():FFmpeg 可能在写入中途崩溃,残留损坏文件;-vcodec h264应改为-vcodec libx264:h264是解码器名称,非编码器,易导致静默失败;-progress不影响主输出流,CombinedOutput()仍可捕获原始日志用于调试;- 生产环境建议搭配超时控制(
cmd.Context())和资源清理(如defer os.Remove(dest))。
总结
-progress 是 FFmpeg 官方提供的、面向自动化集成的核心特性。它提供轻量、稳定、无需额外依赖的机器可读接口,使 Go(或其他语言)能精准区分“成功完成”、“失败退出”和“意外中断”。相比正则解析日志或文件存在性检查,这是最简洁、最可靠、最符合 Unix 哲学的工程实践。










