运行Mediapipe摄像头代码报OpenCV未知C++异常且画面异常

问题排查与解决方案 #

1. 修正代码逻辑错误 #

当前代码存在两处直接触发报错的逻辑问题：

• 未判断cap.read()的返回状态：当帧读取失败时ret为False，此时frame是空对象，直接传入cv2.imshow()会触发底层C++代码的空指针异常，即你遇到的报错。
• 重复调用资源释放方法：连续两次执行cap.release()和cv2.destroyAllWindows()，第一次调用已经释放了摄像头句柄，第二次调用空句柄会直接触发异常。
  修正后的代码参考：

import cv2

# 手动指定摄像头API后端，根据系统选择：Windows用cv2.CAP_DSHOW，Mac用cv2.CAP_AVFOUNDATION，Linux用cv2.CAP_V4L2
cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
# 可选：手动设置采集分辨率，避免默认分辨率不兼容
cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)

while cap.isOpened():
    ret, frame = cap.read()
    # 新增读取失败判断
    if not ret:
        print("帧读取失败，退出循环")
        break
    cv2.imshow('Raw Webcam Feed', frame)
    # 调整等待时间到25ms，适配常规帧率
    if cv2.waitKey(25) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

2. 修复画面黑白、卡顿问题 #

画面异常的核心原因是OpenCV默认采集参数和摄像头硬件不兼容：

• 按上述修正代码的方式手动指定对应系统的摄像头API后端，解决帧格式不匹配导致的黑白画面问题
• 手动设置固定的采集分辨率，避免摄像头自动协商分辨率失败导致的模糊卡顿
• 调整cv2.waitKey()的等待参数到20-30ms区间，匹配常规摄像头的采集帧率

3. 版本兼容性排查 #

最新版本的Mediapipe和OpenCV存在已知的视频采集模块冲突：

• 建议将OpenCV降级到4.5.5版本，Mediapipe降级到0.9.1.0版本，测试是否解决异常
• 若使用conda虚拟环境，避免同时通过conda和pip安装OpenCV，导致多版本冲突

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