JAVA：Spring Boot 集成 FFmpeg 实现多媒体处理

JAVA：Spring Boot 集成 FFmpeg 实现多媒体处理

一、简述

在现代 Web 应用中，音视频处理需求越来越常见，例如：视频转码、截图、音频提取、格式转换等。FFmpeg 是一个功能极其强大的开源音视频处理工具，可以帮助我们高效完成这些任务。本文将介绍如何在 Spring Boot 项目中集成 FFmpeg，并实现一些常见的应用场景。

二、为什么选择 FFmpeg

• 跨平台：支持 Windows、Linux、macOS。
• 强大功能：转码、剪辑、截图、推流、合并分割等应有尽有。
• 社区活跃：资料丰富、持续更新。

Spring Boot + FFmpeg，可以快速构建出一个支持多媒体处理的服务。

1、准备工作

在开发/部署机器上需要安装 FFmpeg，并配置环境变量。

Linux/macOS：

# macOS (Homebrew)
brew install ffmpeg# Ubuntu
sudo apt-get install ffmpeg

Windows：前往 FFmpeg 官网 下载编译好的版本，解压后将 bin 路径加入系统环境变量。

测试是否成功：

ffmpeg -version

2、集成方案

在 Java 中调用 FFmpeg 主要有两种方式：

• 直接调用命令行（通过 ProcessBuilder 或 Runtime.exec）
• 使用 Java 封装库（如 JAVE、FFmpeg CLI Wrapper）

下面重点演示 命令行调用方式，因为它灵活、依赖少，适合快速上手。

三、实践样例

1、定义工具类调用 FFmpeg

package com.example.ffmpeg.util;import java.io.BufferedReader;
import java.io.InputStreamReader;public class FFmpegUtil {/*** 执行 FFmpeg 命令** @param command FFmpeg 命令字符串* @throws Exception*/public static void executeCommand(String command) throws Exception {ProcessBuilder builder = new ProcessBuilder(command.split(" "));builder.redirectErrorStream(true);Process process = builder.start();// 输出日志try (BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()))) {String line;while ((line = reader.readLine()) != null) {System.out.println("[FFmpeg] " + line);}}int exitCode = process.waitFor();if (exitCode != 0) {throw new RuntimeException("FFmpeg 执行失败，退出码：" + exitCode);}}
}

2、常见应用场景

视频转码

String cmd =  "ffmpeg -i input.mp4 output.avi";
FFmpegUtil.executeCommand(cmd);

视频截图

String cmd = "ffmpeg -i input.mp4 -ss 00:00:05 -vframes 1 output.jpg";
FFmpegUtil.executeCommand(cmd);

提取音频

String cmd = "ffmpeg -i input.mp4 -q:a 0 -map a output.mp3";
FFmpegUtil.executeCommand(cmd);

3、提供 REST 接口

package com.example.ffmpeg.controller;import com.example.ffmpeg.util.FFmpegUtil;
import org.springframework.web.bind.annotation .*;@RestController
@RequestMapping("/ffmpeg")
public class FFmpegController {@GetMapping("/screenshot")public String screenshot(@RequestParam String input, @RequestParam String output) {try {String cmd = String.format("ffmpeg -i %s -ss 00:00:02 -vframes 1 %s", input, output);FFmpegUtil.executeCommand(cmd);return "截图成功，输出文件：" + output;} catch (Exception e) {return "截图失败：" + e.getMessage();}}
}

这样，我们就可以通过 HTTP 调用来触发 FFmpeg 的多媒体处理任务。

四、进阶优化

• 异步执行：视频转码可能耗时较长，可以结合 @Async 或消息队列（如 RabbitMQ）异步处理。
• 任务管理：引入数据库保存转码任务状态，便于查询和监控。
• 分布式扩展：结合 Kubernetes / Docker，将 FFmpeg 处理服务水平扩展。
• 日志收集：把 FFmpeg 输出日志统一收集，方便排错。
• FFmpeg 封装库：如果不想写命令，可以考虑使用 ffmpeg-cli-wrapper，以面向对象的方式构建命令。

五、总结

本文介绍了如何在 Spring Boot 项目中集成 FFmpeg，通过命令行调用实现视频转码、截图、音频提取等功能，并提供了 REST 接口示例。

FFmpeg 功能非常丰富，结合 Spring Boot 可以快速构建一个 多媒体处理平台，在实际业务中应用场景广泛，比如短视频应用、直播平台、智能监控等。