MacOS系统下Java通过ProcessBuilder执行FFmpeg命令失败问题求助

1. 参数拆分错误（最高发原因） #

你使用的命令里"0:0"在终端执行时，引号的作用是告知shell这是一个不可拆分的独立参数，但ProcessBuilder不需要引号做参数边界标记，也不会自动处理字符串里的引号。如果直接把整段命令按空格拆分传入ProcessBuilder，会导致-i对应的参数被错误识别为带引号的"0:0"或者被拆分为多个无效参数，触发设备找不到错误。

正确参数写法示例： #

ProcessBuilder pb = new ProcessBuilder(
    "/opt/homebrew/bin/ffmpeg", // 建议写ffmpeg绝对路径，避免环境变量问题
    "-f", "avfoundation",
    "-r", "3",
    "-fpsprobesize", "1",
    "-i", "0:0", // 直接传0:0，不要加引号
    "-ar", "44100",
    "-filter_complex", "amix=inputs=1",
    "-c:v", "h264",
    "-crf", "30",
    "-preset", "ultrafast",
    "-ar", "44100",
    "-pix_fmt", "yuv420p",
    "-aq", "1",
    "file.mp4"
);

2. 系统权限不足 #

MacOS的摄像头、麦克风权限是按应用独立授予的：

• 你直接在终端运行命令时，终端已经被授予了音视频采集权限
• 但运行Java程序的载体（比如IDEA/Eclipse等IDE、jar包对应的启动程序、Java运行时环境）没有获得音视频采集权限，就会触发IO错误。

修复方法： #

打开系统设置 > 隐私与安全性 > 摄像头/麦克风，给运行Java程序的对应应用勾选授权，重启程序后再试。

3. FFmpeg路径不匹配 #

终端的PATH环境变量和Java进程的PATH环境变量可能不一致，导致两端调用的不是同一个FFmpeg二进制文件。建议直接在ProcessBuilder中写FFmpeg的绝对路径，可以在终端执行which ffmpeg获取你当前使用的FFmpeg的完整路径。

4. 进程输出缓冲区阻塞 #

FFmpeg运行时会输出大量日志到标准输出和标准错误流，如果Java侧不主动消费这些流的内容，缓冲区占满后会导致FFmpeg进程被阻塞挂起，最终抛出IO错误。

修复方法： #

启动独立线程消费进程的输出流和错误流：

Process process = pb.start();
// 消费标准输出
new Thread(() -> {
    try (InputStream is = process.getInputStream()) {
        is.transferTo(System.out);
    } catch (IOException e) {
        e.printStackTrace();
    }
}).start();
// 消费错误输出
new Thread(() -> {
    try (InputStream is = process.getErrorStream()) {
        is.transferTo(System.err);
    } catch (IOException e) {
        e.printStackTrace();
    }
}).start();
int exitCode = process.waitFor();

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