OpenCV报错：'NoneType'对象无'shape'属性（摄像头帧读取异常）

错误根源 #

该错误的核心原因是cv2.VideoCapture.read()返回的frame为None，说明摄像头未能成功捕获到帧，与模板图片路径无关（你已确认模板图片正常）。常见触发场景包括：

• 摄像头索引不匹配（多摄像头设备下，0并非目标设备）
• 摄像头被其他程序占用（如浏览器、视频会议软件）
• OpenCV在Jupyter Lab环境下的视频捕获后端兼容性问题
• 摄像头硬件未正确连接或故障

解决方案 #

1. 验证摄像头可用性 #

先确认摄像头在系统中正常工作，且未被其他应用占用。可通过系统自带的摄像头测试工具（如Windows相机应用、Linux Cheese）检查设备状态。

2. 调整摄像头索引 #

尝试更换cv2.VideoCapture()的索引参数，若存在多个摄像头，0可能不是目标设备：

# 尝试自动选择可用摄像头
cap = cv2.VideoCapture(-1)
# 或逐个尝试索引1、2等
# cap = cv2.VideoCapture(1)

3. 添加初始化与帧读取校验 #

在代码中增加摄像头初始化和帧读取的判断逻辑，避免处理空帧：

cap = cv2.VideoCapture(0)
# 检查摄像头是否成功打开
if not cap.isOpened():
    print("无法打开摄像头")
    exit()

while True:
    ret, frame = cap.read()
    # 校验帧读取是否成功
    if not ret or frame is None:
        print("无法获取摄像头帧")
        break
    
    # 后续帧处理逻辑...

4. 指定视频捕获后端（适配Jupyter环境） #

Jupyter Lab的交互式环境可能与OpenCV默认视频后端不兼容，尝试指定对应系统的后端：

# Windows环境使用CAP_DSHOW后端
cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
# Linux环境使用CAP_V4L2后端
# cap = cv2.VideoCapture(0, cv2.CAP_V4L2)

5. 修正ROI裁剪坐标顺序（潜在问题） #

原代码中ROI裁剪的y轴范围写反了（OpenCV图像y坐标从上到下递增），会导致裁剪出空图像，后续ORB匹配也会失效：

# 修正前：y轴范围从下到上，会得到空图像
# cropped = frame[bottom_right_y:top_left_y , top_left_x:bottom_right_x]
# 修正后：y轴范围从上到下
cropped = frame[top_left_y:bottom_right_y , top_left_x:bottom_right_x]

完整修正代码示例 #

import cv2
import numpy as np


def ORB_detector(new_image, image_template):
    image1 = cv2.cvtColor(new_image, cv2.COLOR_BGR2GRAY)
    orb = cv2.ORB_create(1000, 1.2)
    (kp1, des1) = orb.detectAndCompute(image1, None)
    (kp2, des2) = orb.detectAndCompute(image_template, None)
    
    bf = cv2.BFMatcher(cv2.NORM_HAMMING, crossCheck=True)
    matches = bf.match(des1,des2)
    matches = sorted(matches, key=lambda val: val.distance)
    return len(matches)

# 初始化摄像头，指定后端适配Jupyter环境
cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
# 检查摄像头是否成功打开
if not cap.isOpened():
    print("无法打开摄像头")
    exit()

# 加载模板图片
image_template = cv2.imread("phone.jpg", 0) 
if image_template is None:
    print("无法加载模板图片，请检查路径")
    exit()

while True:
    ret, frame = cap.read()
    # 校验帧读取是否成功
    if not ret or frame is None:
        print("无法获取摄像头帧")
        break

    height, width = frame.shape[:2]
    top_left_x = int(width / 3)
    top_left_y = int((height / 2) + (height / 4))
    bottom_right_x = int((width / 3) * 2)
    bottom_right_y = int((height / 2) - (height / 4))

    cv2.rectangle(frame, (top_left_x,top_left_y), (bottom_right_x,bottom_right_y), 255, 3)
    # 修正ROI裁剪顺序
    cropped = frame[top_left_y:bottom_right_y , top_left_x:bottom_right_x]
    frame = cv2.flip(frame,1)

    # 避免裁剪图像为空时调用ORB检测器
    if cropped.size > 0:
        matches = ORB_detector(cropped, image_template)
    else:
        matches = 0

    output_string = "Matches = " + str(matches)
    cv2.putText(frame, output_string, (50,450), cv2.FONT_HERSHEY_COMPLEX, 2, (250,0,150), 2)

    threshold = 250
    if matches > threshold:
        cv2.rectangle(frame, (top_left_x,top_left_y), (bottom_right_x,bottom_right_y), (0,255,0), 3)
        cv2.putText(frame,'Object Found',(50,50), cv2.FONT_HERSHEY_COMPLEX, 2 ,(0,255,0), 2)

    cv2.imshow('Object Detector using ORB', frame)
    if cv2.waitKey(1) == 13: #13是Enter键
        break

cap.release()
cv2.destroyAllWindows()

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