Python OpenCV运行人脸检测代码触发cv::cvtColor的_src.empty断言失败问题

基于Python OpenCV 4.5.1 开发摄像头实时人脸检测功能，运行代码时触发函数断言校验失败，报错定位在cv2.cvtColor灰度转换环节，提示输入源图像为空。

File "C:/Users/EMRE/PycharmProjects/OpencvPhyton/chapter4.py", line 14, in <module>
gray = cv2.cvtColor(frame,cv2.COLOR_BGR2GRAY)
cv2.error: OpenCV(4.5.1) C:\Users\appveyor\AppData\Local\Temp\1\pip-req-build-oduouqig\opencv\modules\imgproc\src\color.cpp:182: error: (-215:Assertion failed) !_src.empty() in function 'cv::cvtColor'

• 空帧未校验：video_capture.read()方法返回两个值，第一个值ret为布尔型，代表是否成功捕获到有效图像。当摄像头被其他程序占用、权限不足、初始化未完成、设备索引错误时，ret会返回False，此时第二个返回值frame为None，直接传入cvtColor函数就会触发空矩阵断言。
• 资源释放逻辑错位：原代码将video_capture.release()和cv2.destroyAllWindows()写在while循环内部，第一次循环执行到末尾时就会提前回收摄像头资源，后续循环再读取帧时必然返回空值，直接触发报错。
• 路径拼写错误：原代码中的模型路径Resouces为拼写错误（正确拼写为Resources），会导致Haar级联分类器加载为无效空对象，虽不会直接触发cvtColor报错，但会导致整个检测链路异常。
• 矩形绘制参数不规范：原代码中cv2.rectangle(frame,(x,y)+(x+w,y+h),(0,255,0),2)的写法依赖元组拼接实现坐标传递，部分OpenCV版本会无法识别合法坐标参数，连带引发图像帧处理异常。

• 读取帧后增加状态校验：拿到read()的返回值后先判断ret为True才继续后续图像转换流程，读取失败时直接跳出循环，避免对空对象做运算。
• 调整资源释放位置：将摄像头释放、窗口销毁的逻辑移到while循环外部，仅在按下退出键跳出循环后执行一次资源回收。
• 增加组件初始化校验：创建VideoCapture对象后调用isOpened()方法确认摄像头可正常访问，加载CascadeClassifier后调用empty()方法确认模型加载成功，不满足条件时直接抛出明确错误提示。
• 规范参数写法：将矩形绘制的坐标参数拆分为两个独立的点坐标，避免依赖元组拼接的非兼容写法。

import cv2
import sys
import numpy as np

# 修正模型路径拼写，增加加载状态校验
faceCascade = cv2.CascadeClassifier("Resources/haarcascade_frontalface_default.xml")
if faceCascade.empty():
    raise IOError("人脸检测模型加载失败，请检查文件路径")

# 初始化摄像头，增加可访问性校验
video_capture = cv2.VideoCapture(0)
if not video_capture.isOpened():
    raise IOError("摄像头无法访问，请检查设备连接与权限")

while True:
    # 逐帧捕获摄像头画面
    ret, frame = video_capture.read()
    # 空帧校验，无有效画面时直接退出
    if not ret:
        print("未读取到有效摄像头画面")
        break

    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)

    faces = faceCascade.detectMultiScale(
        gray,
        scaleFactor=1.1,
        minNeighbors=5,
        minSize=(30, 30),
        flags=cv2.CASCADE_SCALE_IMAGE
    )

    # 规范矩形绘制参数
    for (x, y, w, h) in faces:
        cv2.rectangle(frame, (x, y), (x+w, y+h), (0, 255, 0), 2)

    cv2.imshow('Video', frame)

    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

# 资源释放逻辑移至循环外部
video_capture.release()
cv2.destroyAllWindows()

内容的提问来源于stack exchange，提问作者ms.bigdatax