树莓派Pi Camera采集图像黑屏，libcamera-still正常求助

已知Pi Camera在libcamera-still下正常工作，但用OpenCV采集时出现黑屏，即便跳过帧也无法解决，可尝试以下方案：

• 修正VideoCapture初始化配置
  树莓派的libcamera框架替代了旧的raspicam，OpenCV默认的初始化方式可能不兼容。需指定V4L2后端并设置合理分辨率：

  # 初始化摄像头时指定设备路径和V4L2后端
  cap = cv2.VideoCapture("/dev/video0", cv2.CAP_V4L2)
  # 强制设置摄像头分辨率（匹配硬件支持的参数）
  cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640)
  cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)
  

  启动脚本时可添加环境变量屏蔽libcamera日志干扰：

  LIBCAMERA_LOG_LEVEL=error python your_script.py
  

• 检查并修复摄像头权限
  确保当前用户拥有摄像头访问权限，执行以下命令添加用户到video组：

  sudo usermod -a -G video $USER
  

  执行后重启设备生效。

• 优化帧跳过逻辑
  原代码仅循环调用cap.read()但未校验读取结果，可能跳过的都是无效帧。调整为校验读取状态后再跳过：

  def getImg(display=False, size=[480, 240], skip_frames=30):
      # 循环读取直到获取有效帧，再完成剩余跳过次数
      for _ in range(skip_frames):
          success, _ = cap.read()
          if not success:
              continue
      # 读取目标帧
      success, img = cap.read()
      if not success or img is None:
          print("Failed to capture image. Retrying...")
          return None
      img = cv2.resize(img, (size[0], size[1]))
      if display:
          cv2.imshow('IMG', img)
      return img
  

• 更新OpenCV至兼容libcamera的版本
  旧版OpenCV对libcamera支持不佳，执行命令更新：

  # 系统包管理器更新
  sudo apt update && sudo apt install python3-opencv libopencv-dev
  # 或用pip更新到最新版
  pip install --upgrade opencv-python opencv-contrib-python
  

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