MacOS下OpenCV Java版VideoWriter无法正常工作的问题排查

我刚仔细梳理了你的测试代码、环境信息和遇到的问题，这种所有编码-容器组合都失效的情况，通常是编解码器支持不匹配和代码中FOURCC/容器的错误搭配共同导致的，下面一步步拆解原因和解决方案：

问题根源分析 #

1. FOURCC编码与容器格式不兼容 #

你测试的很多组合本身就不符合行业标准，比如：

• X264/H264编码通常对应mp4容器，而非mov/avi/mpg
• FMP4是容器格式（Fragmented MP4），不是编码格式，不能作为FOURCC参数传入
• 部分FOURCC的大小写不匹配：比如OpenCV中X264有时需要小写x264，MJPG在部分系统要求mjpg
• MP4V对应MPEG-4编码，适合mp4/avi，但和mov搭配兼容性极差

2. OpenCV编译时缺失编解码器支持 #

你的OpenCV版本（3.4.8/3.4.3）如果是通过包管理器（MacPorts/Apt）安装的，默认可能没有启用FFmpeg或者系统原生编解码器的完整支持，导致VideoWriter无法找到可用的编码后端。比如MacOS上的QuickTime编解码器对部分FOURCC支持有限，Ubuntu上如果没有安装带FFmpeg支持的OpenCV包，也会直接失效。

3. 代码中的细节错误 #

• 你在VideoRecorder中初始化FOURCC为小写mp4v，但测试数组里是大写MP4V，虽然fourcc()方法不区分大小写，但可能导致部分系统识别异常
• 没有检查VideoWriter的初始化状态：save.isOpened()返回false的话，说明编码器初始化失败，后续写入都是无效的，你的测试只检查文件存在，没验证视频是否可播放

解决方案 #

第一步：修正编码-容器的有效组合 #

先只测试经过验证的兼容组合，避免无效尝试：

修改你的exts和FOURCCs数组为：

public static String exts[]= {"avi", "mp4", "mov"};
public static String FOURCCs[]= { "MJPG", "x264", "avc1", "MP4V" };

第二步：确保OpenCV有完整的编解码器支持 #

• MacOS：卸载MacPorts的OpenCV，用Homebrew重新安装带FFmpeg支持的版本：

  brew install opencv --with-ffmpeg
  

• Ubuntu：安装带FFmpeg支持的OpenCV包：

  sudo apt-get install libopencv-dev libopencv-videoio-dev ffmpeg
  

  如果是手动编译OpenCV，要确保在CMake中启用WITH_FFMPEG=ON和WITH_QUICKTIME=ON（MacOS）。

第三步：修复代码中的关键问题 #

1. 添加VideoWriter初始化检查，提前发现错误：
   在start()方法中加入：

   save = new VideoWriter(path, fourcc, this.fps, this.frameSize, isColor);
   if (!save.isOpened()) {
       System.err.println("Failed to open VideoWriter for: " + path + " with FOURCC: " + FOURCC);
       throw new RuntimeException("VideoWriter initialization failed");
   }
   

2. 统一FOURCC的大小写，避免系统识别问题：
   修改fourcc()调用为：

   String fourccStr = FOURCC.toLowerCase();
   int fourcc = VideoWriter.fourcc(fourccStr.charAt(0), fourccStr.charAt(1), fourccStr.charAt(2), fourccStr.charAt(3));
   

3. 测试时验证视频文件的有效性：除了检查文件存在，还可以用FFmpeg命令验证（在测试代码中调用或者手动检查）：

   ffmpeg -v error -i test_file.mp4 -f null -
   

   如果没有输出错误，说明视频文件有效。

第四步：替代方案（如果上述方法仍失效） #

如果系统编解码器确实无法正常工作，可以考虑直接使用FFmpeg的Java绑定（比如javacv）来录制视频，它对编解码器的支持更全面，兼容性更好。

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