Java调用FFmpeg报错‘Trailing garbage after a filter’的原因与解决

错误原因 #

出现Trailing garbage after a filter错误的核心问题有两个：

1. FFmpeg命令语法错误：测试命令中-filter_complex的滤镜链结尾多了一个分号;，FFmpeg解析滤镜时会将分号后的内容视为无效的垃圾字符，触发报错。
2. Java命令执行的转义/格式问题：直接用Runtime.getRuntime().exec拼接长命令时，容易出现引号转义、换行符处理不当的情况，导致滤镜链被错误解析。

解决步骤 #

1. 修正FFmpeg命令语法 #

首先去掉-filter_complex中最后一个滤镜标签后的分号：

• 修正后的测试Docker命令：

docker run --rm -v sample-test:/config linuxserver/ffmpeg -loop 1 -t 5 -i config/1.jpeg -loop 1 -t 5 -i config/3.jpeg -y -filter_complex "[0:v]fade=t=out:st=4:d=1[v0]; [1:v]fade=t=in:st=0:d=1,fade=t=out:st=4:d=1[v1]; [v0][v1]concat=n=2:v=1:a=0,format=yuv420p[v]" -map "[v]" config/output/video_java.mp4

2. 优化Java中命令执行的方式 #

不推荐用Runtime.getRuntime().exec拼接长命令，建议使用ProcessBuilder构建命令，避免转义问题，稳定性更强：

import java.util.Arrays;
import java.io.IOException;

public class FFmpegVideoGenerator {
    public static void main(String[] args) throws IOException, InterruptedException {
        List<String> ffmpegCommand = Arrays.asList(
            "ffmpeg",
            "-loop", "1", "-t", "5", "-i", "input0.png",
            "-loop", "1", "-t", "5", "-i", "input1.png",
            "-loop", "1", "-t", "5", "-i", "input2.png",
            "-loop", "1", "-t", "5", "-i", "input3.png",
            "-loop", "1", "-t", "5", "-i", "input4.png",
            "-filter_complex",
            "[0:v]scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2,setsar=1,fade=t=out:st=4:d=1[v0]; " +
            "[1:v]scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2,setsar=1,fade=t=in:st=0:d=1,fade=t=out:st=4:d=1[v1]; " +
            "[2:v]scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2,setsar=1,fade=t=in:st=0:d=1,fade=t=out:st=4:d=1[v2]; " +
            "[3:v]scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2,setsar=1,fade=t=in:st=0:d=1,fade=t=out:st=4:d=1[v3]; " +
            "[4:v]scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2,setsar=1,fade=t=in:st=0:d=1,fade=t=out:st=4:d=1[v4]; " +
            "[v0][v1][v2][v3][v4]concat=n=5:v=1:a=0,format=yuv420p[v]",
            "-map", "[v]",
            "out.mp4"
        );

        ProcessBuilder pb = new ProcessBuilder(ffmpegCommand);
        pb.inheritIO(); // 可选，将FFmpeg的输出同步到Java控制台
        Process process = pb.start();
        int exitCode = process.waitFor();

        if (exitCode == 0) {
            System.out.println("视频生成成功");
        } else {
            System.err.println("视频生成失败，退出码：" + exitCode);
        }
    }
}

为什么用ProcessBuilder更好？ #

它将每个命令参数作为独立字符串传递，完全避免了shell解析时的引号、空格、转义问题，比Runtime.exec更适合处理复杂的FFmpeg命令。

内容的提问来源于stack exchange，提问作者coenni