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

文章目录

[JAVA：Spring Boot 集成 FFmpeg 实现多媒体处理](#JAVA：Spring Boot 集成 FFmpeg 实现多媒体处理)
一、简述
[二、为什么选择 FFmpeg](#二、为什么选择 FFmpeg)
- 1、准备工作
- 2、集成方案
三、实践样例
- [1、定义工具类调用 FFmpeg](#1、定义工具类调用 FFmpeg)
- 2、常见应用场景
- [3、提供 REST 接口](#3、提供 REST 接口)
四、进阶优化
五、总结

一、简述

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

二、为什么选择 FFmpeg

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

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

1、准备工作

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

Linux/macOS：

bash 复制代码

# macOS (Homebrew)
brew install ffmpeg

# Ubuntu
sudo apt-get install ffmpeg

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

测试是否成功：

bash 复制代码

ffmpeg -version

2、集成方案

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

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

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

三、实践样例

1、定义工具类调用 FFmpeg

java 复制代码

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、常见应用场景

视频转码

java 复制代码

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

视频截图

java 复制代码

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

提取音频

java 复制代码

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

3、提供 REST 接口

java 复制代码

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 可以快速构建一个 多媒体处理平台，在实际业务中应用场景广泛，比如短视频应用、直播平台、智能监控等。