调用OpenCV的VideoCapture(0)捕获摄像头图像时抛出未知异常的解决求助

• 检查摄像头占用与权限

  • 桌面端：先确认摄像头没被其他程序占用（比如微信、浏览器、Zoom这类），关闭所有占用摄像头的软件后重试。Linux系统下，要确保当前用户属于video用户组，执行命令sudo usermod -aG video 你的用户名，重启系统后生效。
  • Android端：在AndroidManifest.xml中添加相机权限<uses-permission android:name="android.permission.CAMERA"/>，同时在代码中动态申请运行时权限（Android 6.0及以上版本要求）。

• 确认OpenCV库加载正确

  • 必须在创建VideoCapture实例前加载OpenCV本地库，执行System.loadLibrary(Core.NATIVE_LIBRARY_NAME);，不要颠倒顺序。
  • 检查OpenCV库的架构与系统匹配：64位系统用64位OpenCV库，32位系统对应32位库，混用会导致兼容性问题。

• 尝试指定摄像头索引或后端API

  • 部分系统的默认摄像头索引不是0，可以尝试索引1、2，比如new VideoCapture(1);。
  • 强制指定视频捕获后端API，避免系统自动选择出错：
    • Windows平台：new VideoCapture(0, Videoio.CAP_DSHOW);
    • Linux平台：new VideoCapture(0, Videoio.CAP_V4L2);
    • macOS平台：new VideoCapture(0, Videoio.CAP_AVFOUNDATION);

• 补充依赖环境

  • Windows：安装对应版本的VC++运行库，OpenCV的Java绑定依赖该运行库才能正常调用摄像头。
  • Linux：安装必要的系统依赖包，比如Ubuntu下执行sudo apt install libopencv-videoio-dev。

• 运行最简测试程序排查
  写一个极简的测试代码，排除业务代码干扰，确认环境是否正常：

  import org.opencv.core.Core;
  import org.opencv.videoio.VideoCapture;
  
  public class CameraTest {
      public static void main(String[] args) {
          System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
          VideoCapture cap = new VideoCapture(0);
          if (cap.isOpened()) {
              System.out.println("摄像头打开成功");
              cap.release();
          } else {
              System.out.println("无法打开摄像头");
          }
      }
  }
  

  如果这个程序依然报错，说明问题出在环境配置而非业务代码，重点排查前面的权限、库加载步骤。

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