Jetson Xavier NX运行OpenCV出现V4L2摄像头按索引无法打开报错如何解决

终端报错信息：

[ WARN:0] global /home/arc/opencv_build/opencv/modules/videoio/src/cap_v4l.cpp (890) open VIDEOIO(V4L2:/dev/video0): can't open camera by index
Traceback (most recent call last):
File "realtime_quadrant.py", line 41, in 
height = frame.shape
AttributeError: 'NoneType' object has no attribute 'shape'

按以下步骤排查解决：

• 第一步：确认系统识别到摄像头设备
  执行命令ls /dev/video*查看所有可用的视频设备节点。Jetson常用的官方MIPI CSI摄像头默认不会枚举为/dev/video0这类V4L2设备，需要走GStreamer管道才能调用，只有USB摄像头才会显示为/dev/video开头的节点。如果执行该命令无任何输出，先排查摄像头接线是否松动、CSI摄像头驱动是否正常安装。
• 第二步：排查USB摄像头访问权限
  如果你确认使用的是USB摄像头且能看到对应的/dev/videoX节点，执行sudo usermod -aG video $USER将当前用户加入video用户组，执行完成后重启系统生效，避免普通用户无权限访问摄像头设备。
• 第三步：使用Jetson平台适配的摄像头调用写法
  Jetson平台的MIPI CSI摄像头不能直接通过cv2.VideoCapture(数字索引)调用，需要传入拼接好的GStreamer管道字符串，参考代码示例：

  import cv2
  
  def gstreamer_pipeline(
      capture_width=1280,
      capture_height=720,
      display_width=1280,
      display_height=720,
      framerate=30,
      flip_method=0,
  ):
      return (
          "nvarguscamerasrc ! "
          "video/x-raw(memory:NVMM), "
          f"width=(int){capture_width}, height=(int){capture_height}, "
          f"format=(string)NV12, framerate=(fraction){framerate}/1 ! "
          f"nvvidconv flip-method={flip_method} ! "
          f"video/x-raw, width=(int){display_width}, height=(int){display_height}, format=(string)BGRx ! "
          "videoconvert ! "
          "video/x-raw, format=(string)BGR ! appsink"
      )
  
  if __name__ == "__main__":
      cap = cv2.VideoCapture(gstreamer_pipeline(flip_method=0), cv2.CAP_GSTREAMER)
      if cap.isOpened():
          while True:
              ret, frame = cap.read()
              if not ret:
                  break
              # 此处替换为你自己的业务逻辑
              cv2.imshow("frame", frame)
              if cv2.waitKey(1) & 0xFF == ord('q'):
                  break
          cap.release()
          cv2.destroyAllWindows()
  

  如果你使用的是USB摄像头，也可以尝试明确指定V4L2后端打开对应设备索引，写法为cap = cv2.VideoCapture(0, cv2.CAP_V4L2)。
• 第四步：确认OpenCV编译时启用了对应后端
  你报错中的OpenCV是自行编译的版本，执行python3 -c "import cv2; print(cv2.getBuildInformation())"查看编译配置，确认Video I/O部分的GStreamer、V4L2选项状态为YES，如果对应后端未启用，需要重新编译OpenCV，勾选对应后端选项后再安装。

内容的提问来源于stack exchange，提问作者Rabia Tüylek