Python OpenCV无法访问相机：执行代码触发HIGHGUI ERROR: V4L/V4L2错误

看起来你在Jetson平台上用OpenCV调用相机时遇到了V4L/V4L2的错误，我来帮你一步步解决这个问题：

1. 先排查设备权限与索引问题 #

这个错误最常见的原因是设备权限不足或者相机设备索引不对：

• 先检查系统里的视频设备：在终端运行 ls /dev/video*，会列出所有可用的相机设备（比如 /dev/video0、/dev/video1），你可以尝试把代码里的0换成其他索引试试；
• 如果是权限问题，把当前用户加入video组：

  sudo usermod -aG video $USER
  

  执行完后注销再重新登录，权限就生效了。

2. 使用适配Jetson平台的GStreamer管道 #

你代码里注释的GStreamer管道是针对Jetson的，但nvcamerasrc在较新的Jetson系统中已经被弃用了，建议改用更兼容的v4l2src，替换成下面的初始化代码：

# 替换原有的cap初始化行
cap = cv2.VideoCapture(
    "v4l2src device=/dev/video0 ! video/x-raw, width=1280, height=720, framerate=24/1 ! nvvidconv flip-method=2 ! video/x-raw, format=BGRx ! videoconvert ! video/x-raw, format=BGR ! appsink",
    cv2.CAP_GSTREAMER
)

解释一下这个管道：

• v4l2src是标准的V4L2相机源，兼容性更好；
• nvvidconv利用Jetson的硬件加速做格式转换和翻转（flip-method=2是垂直翻转，你可以根据需要改成0-7的其他值）；
• 最后转换成OpenCV能识别的BGR格式，避免格式不兼容的问题。

3. 修复代码中的循环逻辑问题 #

你的原代码有两个小问题：

1. while(True)没有退出条件，会无限循环；
2. 每次循环都执行cv2.imwrite，会反复覆盖同一张图片，而且如果cap.read()失败返回空帧，会导致后续cvtColor报错。

修改后的完整代码：

import cv2

# 使用适配Jetson的GStreamer管道
cap = cv2.VideoCapture(
    "v4l2src device=/dev/video0 ! video/x-raw, width=1280, height=720, framerate=24/1 ! nvvidconv flip-method=2 ! video/x-raw, format=BGRx ! videoconvert ! video/x-raw, format=BGR ! appsink",
    cv2.CAP_GSTREAMER
)

# 检查相机是否成功打开
if not cap.isOpened():
    print("无法打开相机设备")
    exit()

while True:
    ret, frame = cap.read()
    # 如果读取帧失败，退出循环
    if not ret:
        print("无法读取相机帧")
        break
    
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    cv2.imshow('frame', gray)
    
    # 按's'键保存图片，按'q'键退出
    key = cv2.waitKey(1) & 0xFF
    if key == ord('s'):
        cv2.imwrite('cameratest.png', frame)
        print("图片已保存为cameratest.png")
    elif key == ord('q'):
        break

# 释放资源
cap.release()
cv2.destroyAllWindows()

4. 确认OpenCV是否支持GStreamer #

如果上面的方法还是不行，检查你的OpenCV编译时是否开启了GStreamer支持：

import cv2
print(cv2.getBuildInformation())

在输出中找到GStreamer那一行，如果显示NO，你需要重新编译OpenCV并开启WITH_GSTREAMER选项。

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