Python运行OpenCV人脸检测程序触发!empty()断言报错求助

报错核心信息 #

运行人脸检测代码时，在调用face_cascade.detectMultiScale行触发错误：

cv2.error: OpenCV(4.5.5) ... error: (-215:Assertion failed) !empty() in function 'cv::CascadeClassifier::detectMultiScale'

错误本质是级联分类器对象为空，未成功加载模型文件，触发了OpenCV源码里的非空校验逻辑。

原问题代码 #

import cv2

face_cascade=cv2.CascadeClassifier("haarcascade_frontalface_default.xml")

img=cv2.imread("C:\\Users\\Maxy\\PycharmProjects\\Learn Python\\denzel.jpg", 1)

gray_img=cv2.cvtColor(img, cv2.COLOR_RGB2GRAY)

faces = face_cascade.detectMultiScale(gray_img, scaleFactor=1.05, minNeighbors=5)

print(type(faces))
print(faces)

for x,y,w,h in faces:
    img = cv2.rectangle(img, (x,y), (x+w,y+h), (0,255,0), 3)

cv2.imshow("Gray", img)
cv2.waitKey(0)

根因分析 #

• 核心原因：直接传入haarcascade_frontalface_default.xml文件名作为分类器路径时，Python运行的工作目录和文件存放位置不匹配，OpenCV找不到该XML模型文件，导致分类器初始化后是空对象。
• 潜在隐患：
  • 没有校验图片读取结果，若图片路径错误cv2.imread会返回None，后续流程也会触发同类空报错
  • 色彩空间转换常量使用错误：cv2.imread默认读取的图片为BGR通道顺序，使用COLOR_RGB2GRAY做转换会导致灰度图生成异常，降低人脸检测准确率

修复方案 #

1. 不要手动写相对路径加载级联模型，直接调用OpenCV内置的haar级联文件路径，避免路径不匹配问题，加载后增加空校验提前拦截错误
2. 读取图片后增加空校验，确认图片成功加载
3. 修正色彩空间转换常量为cv2.COLOR_BGR2GRAY

修复后完整可运行代码 #

import cv2
import os

# 加载OpenCV内置的人脸检测级联模型
cascade_path = os.path.join(cv2.data.haarcascades, "haarcascade_frontalface_default.xml")
face_cascade = cv2.CascadeClassifier(cascade_path)
if face_cascade.empty():
    raise RuntimeError("人脸检测模型加载失败，请检查OpenCV安装是否完整")

# 读取测试图片
img = cv2.imread("C:\\Users\\Maxy\\PycharmProjects\\Learn Python\\denzel.jpg", 1)
if img is None:
    raise RuntimeError("测试图片读取失败，请检查图片路径是否存在中文/拼写错误")

# 转灰度图（修正色彩空间常量）
gray_img = cv2.cvtColor(img, cv2.COLOR_BGR2GRAY)

faces = face_cascade.detectMultiScale(gray_img, scaleFactor=1.05, minNeighbors=5)

print(type(faces))
print(faces)

for x,y,w,h in faces:
    img = cv2.rectangle(img, (x,y), (x+w,y+h), (0,255,0), 3)

cv2.imshow("Face Detection Result", img)
cv2.waitKey(0)
cv2.destroyAllWindows()

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