树莓派4安装Raspberry Pi OS Lite 64后OpenCV无法打开USB摄像头

一、先排查系统层面的摄像头识别问题 #

• 检查系统是否识别到USB摄像头：执行 ls /dev/video*，如果输出里没有/dev/video0或类似设备文件，说明摄像头未被系统识别。此时需排查：
  • USB接口供电是否足够（可换个USB口或用带供电的USB hub）
  • 摄像头本身是否正常（换其他设备测试）
  • 系统内核是否支持该摄像头：执行dmesg | grep usb，查看是否有摄像头相关的识别日志，若有报错可能需要安装对应驱动（部分小众摄像头需手动编译驱动）
• 如果能看到/dev/video*设备，继续下一步

二、检查用户权限 #

• /dev/video*设备默认属于video用户组，当前用户若不在该组会无法访问。执行groups查看当前用户所属组，若没有video：
  • 执行sudo usermod -aG video $USER将用户加入video组
  • 重启系统或重新登录生效

三、用系统工具验证摄像头功能 #

• 安装v4l2工具：sudo apt update && sudo apt install v4l-utils
• 查看摄像头设备详情：v4l2-ctl --list-devices，确认摄像头对应的设备路径（比如/dev/video0）
• 测试拍摄：v4l2-ctl --device=/dev/video0 --stream-mmap --stream-to=test.raw --stream-count=1，如果能生成test.raw文件，说明摄像头硬件和驱动正常，问题出在OpenCV配置

四、修复OpenCV的配置问题 #

情况1：通过apt安装的OpenCV #

• 先卸载现有包：sudo apt remove --purge libopencv* python3-opencv
• 重新安装完整的OpenCV包：sudo apt install python3-opencv libopencv-videoio-dev
• 安装完成后测试代码，直接指定设备路径而非索引：

import cv2

# 直接指定设备路径并强制使用V4L2后端
cap = cv2.VideoCapture('/dev/video0', cv2.CAP_V4L2)
if not cap.isOpened():
    print("摄像头打开失败")
    exit()

ret, img = cap.read()
if ret:
    cv2.imwrite("photo.jpg", img)
else:
    print("无法读取摄像头画面")

cap.release()

情况2：源码编译的OpenCV #

• 重新编译时需确保启用V4L2支持，编译命令添加参数：

cmake -D CMAKE_BUILD_TYPE=RELEASE \
      -D CMAKE_INSTALL_PREFIX=/usr/local \
      -D WITH_V4L=ON \  # 关键参数，启用V4L2支持
      -D BUILD_opencv_python3=ON \
      ..

• 编译安装完成后再测试代码

五、代码优化建议 #

• 必须检查cap.isOpened()和cap.read()的返回值，避免因读取失败导致后续操作出错
• 不要在死循环中持续写入同一张图片，会频繁覆盖且浪费资源，拍摄完成后及时释放摄像头

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