树莓派3双摄像头切换报cv2.error(-215)，分辨率调整后故障

先给你拆解下这个错误的本质——你看到的cv2.error: (-215) total() == 0 || data != __null其实是OpenCV在说它拿到了一个空的图像帧对象（Mat），说白了就是切换到2号摄像头时，要么设备没被正确识别，要么根本没捕获到画面。结合你调整分辨率后出问题、改回去也没用的情况，我给你整理了几个针对性的排查步骤，一步步来应该能解决：

一、先排查USB硬件层面的异常 #

树莓派的USB2.0带宽真的很有限，两个1024x768的摄像头同时跑很容易把带宽占满，哪怕你改回低分辨率，设备可能已经因为过载进入异常状态了：

• 重新插拔摄像头：先断开两个摄像头的USB连接，等10秒后先插1号、再插2号，插完用ls /dev/video*命令查看，应该能看到video0和video1两个设备节点，说明系统识别正常
• 检查供电是否足够：双摄像头同时工作很吃供电，建议给树莓派换个5V/3A的正经电源，或者给摄像头用带独立供电的USB集线器，避免因为供电不足导致摄像头掉帧或初始化失败
• 单独测试2号摄像头：只插2号摄像头，跑一段极简测试代码验证它本身能不能工作：

  import cv2
  
  # 设备节点可能是0或1，根据ls /dev/video*的结果调整
  cap = cv2.VideoCapture(1)
  if not cap.isOpened():
      print("2号摄像头连不上啊！")
      exit()
  # 尝试捕获一帧
  ret, frame = cap.read()
  if ret:
      print("成功抓到帧啦！分辨率是：", frame.shape)
      cv2.imwrite("test_cam2.jpg", frame)
  else:
      print("还是抓不到帧...")
  cap.release()
  

二、重置OpenCV的摄像头配置缓存 #

调整分辨率后，OpenCV可能残留了旧的设备配置，哪怕你改回低分辨率，它还是按之前的错误参数去初始化摄像头：

• 强制指定参数初始化：切换摄像头时，别依赖默认设置，手动把分辨率、帧率这些参数写死，确保和摄像头支持的规格匹配（Kayeton KYT-U200-R01支持1024x768@30fps）：

  def init_camera(cam_id, width=640, height=480):
      cap = cv2.VideoCapture(cam_id)
      if not cap.isOpened():
          return None
      # 强制覆盖缓存的旧配置
      cap.set(cv2.CAP_PROP_FRAME_WIDTH, width)
      cap.set(cv2.CAP_PROP_FRAME_HEIGHT, height)
      cap.set(cv2.CAP_PROP_FPS, 30)
      # 先读几帧丢弃，让摄像头稳定下来
      for _ in range(5):
          cap.read()
      return cap
  

• 彻底释放摄像头资源：切换摄像头时，一定要调用cap.release()把前一个摄像头的资源彻底释放，不然设备会被占用，新摄像头根本连不上：

  # 切换摄像头的正确姿势示例
  current_cam = init_camera(0)
  # 用current_cam做你要做的事...
  current_cam.release()  # 这步绝对不能忘！
  current_cam = init_camera(1)
  

三、修复系统层面的视频驱动异常 #

如果上面的步骤都没用，可能是树莓派的v4l2视频驱动出问题了：

• 重置v4l2驱动：执行下面的命令，把视频驱动先卸载再重新加载，相当于给驱动重启：

  sudo rmmod uvcvideo
  sudo modprobe uvcvideo
  

• 确认摄像头支持的真实分辨率：用v4l2-ctl工具看看2号摄像头实际支持哪些分辨率，别自己瞎设置：

  v4l2-ctl -d /dev/video1 --list-formats-ext
  

  找输出里Pixel Format: 'MJPG'或YUYV对应的分辨率，确保你代码里设置的是摄像头真的能支持的规格。

四、最后的兜底方案 #

如果以上方法都不管用，可能是摄像头固件状态异常了：

• 重置摄像头固件：把2号摄像头拔下来，等30秒再插回去，很多USB摄像头会自动重置固件状态
• 重新安装OpenCV：如果是OpenCV安装文件损坏导致的问题，可以重新编译安装适配树莓派的稳定版本（推荐3.4.5或更高）

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