RTSP流在ROS Python脚本中失效，终端GStreamer/VLC可正常运行

1. 检查Python环境的GStreamer绑定一致性 #

• 在Python终端执行以下代码，验证GStreamer库是否正常加载，且版本与终端环境匹配：

  import gi
  gi.require_version('Gst', '1.0')
  from gi.repository import Gst
  Gst.init(None)
  print(Gst.version_string())
  

  对比终端执行gst-launch-1.0 --version输出的版本号。若版本不一致，说明Python环境调用的GStreamer与系统全局版本不兼容，需对齐环境依赖。

2. 确认OpenCV的GStreamer编译支持 #

• 若脚本基于OpenCV读取流，先检查当前OpenCV是否启用GStreamer支持：

  import cv2
  print(cv2.getBuildInformation())
  

  在输出中查找GStreamer项，若显示NO，则当前Python环境的OpenCV未绑定GStreamer——这是核心问题：终端的gst-launch依赖系统GStreamer，但OpenCV无法调用。
• 解决方式：卸载现有OpenCV，改用ROS官方源安装带GStreamer支持的版本（如对应Ubuntu20.04的ROS Noetic：apt-get install ros-noetic-opencv-python），或从源码编译OpenCV时开启WITH_GSTREAMER编译选项。

3. 强制OpenCV使用GStreamer后端读取流 #

• 终端可用的GStreamer管道可直接复用在Python脚本中，避开OpenCV默认的RTSP处理逻辑（可能基于FFmpeg）。修改流初始化代码：
  原代码：

  cap = cv2.VideoCapture("rtsp://192.168.4.21:8554/h264")
  

  修改为：

  gst_pipeline = "rtspsrc location=rtsp://192.168.4.21:8554/h264 ! rtph264depay ! avdec_h264 ! videoconvert ! appsink"
  cap = cv2.VideoCapture(gst_pipeline, cv2.CAP_GSTREAMER)
  

4. 排查FFmpeg后端兼容性（若使用） #

• 若OpenCV默认用FFmpeg读取RTSP，可测试FFmpeg本身是否兼容摄像头的RTSP服务器：

  import subprocess
  result = subprocess.run(["ffmpeg", "-i", "rtsp://192.168.4.21:8554/h264", "-vcodec", "copy", "-f", "null", "-"], capture_output=True, text=True)
  print(result.stderr)
  

  若输出同样的501 Not Implemented错误，说明FFmpeg的RTSP协议实现与摄像头不兼容，必须切换到GStreamer后端。

5. 确认Docker容器网络权限 #

• 虽然终端能访问流，但仍需确认容器启动时是否添加了--net=host参数，或正确映射了RTSP端口（8554），避免容器网络隔离导致的访问问题。

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