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

news/2025/11/7 17:08:37/文章来源:https://www.cnblogs.com/yangykaifa/p/19200297

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

文章目录

JAVA：Spring Boot 集成 FFmpeg 实现多媒体处理
一、简述
二、为什么选择 FFmpeg
- 1、准备工作
- 2、集成方案
三、实践样例
四、进阶优化
五、总结

一、简述

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

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();
}
}
}