OpenCV人脸检测触发(-215:Assertion failed)报错，求解决办法

核心问题分析 #

报错信息里的两个问题是连锁的：

1. 首先出现的Can't open file提示，说明人脸分类器的XML文件未被正确读取
2. 后续的!empty()断言失败，是因为分类器加载为空，导致detectMultiScale函数无法执行

排查与解决步骤 #

• 验证分类器文件完整性
  你可能下载的XML文件已损坏，重新获取haarcascade_frontalface_default.xml文件，确保文件大小正常（约900KB）。

• 使用OpenCV自带的分类器路径
  跳过手动指定路径的麻烦，直接调用OpenCV安装包内置的分类器，代码修改为：

  yuz_cascade = cv2.CascadeClassifier(cv2.data.haarcascades + 'haarcascade_frontalface_default.xml')
  

  这种方式能避免路径拼写、文件权限或位置错误的问题。

• 修复未定义变量
  你的代码中kac_yuz_algilama变量未定义，即使分类器加载成功，运行到循环时也会报错，需提前定义该变量，比如kac_yuz_algilama = 1。

• 添加加载验证逻辑
  在代码中加入分类器加载验证，提前定位问题：

  if yuz_cascade.empty():
      print("分类器加载失败，请检查文件路径或完整性")
      exit()
  

• 处理摄像头异常情况
  摄像头可能未正常打开，添加判断逻辑避免后续报错：

  cap = cv2.VideoCapture(0)
  if not cap.isOpened():
      print("摄像头无法打开")
      exit()
  ret, img = cap.read()
  if not ret:
      print("无法读取摄像头画面")
      cap.release()
      exit()
  

修正后的完整代码 #

import cv2

# 加载OpenCV内置人脸分类器
yuz_cascade = cv2.CascadeClassifier(cv2.data.haarcascades + 'haarcascade_frontalface_default.xml')

# 验证分类器加载状态
if yuz_cascade.empty():
    print("分类器加载失败，请检查文件")
    exit()

# 初始化并检查摄像头
cap = cv2.VideoCapture(0)
if not cap.isOpened():
    print("摄像头无法打开")
    exit()

ret, img = cap.read()
if not ret:
    print("无法获取摄像头画面")
    cap.release()
    exit()

# 检测人脸
yuzler = yuz_cascade.detectMultiScale(img, 1.3, 5)

# 定义要检测的人脸数量
kac_yuz_algilama = 1
for (x, y, w, h) in yuzler[:kac_yuz_algilama]:
    cv2.rectangle(img, (x, y), (x + w, y + h), (0, 230, 0), 2)
    yuz = img[y:y+h, x:x+w]

cv2.imshow("Pencere", img)
cv2.waitKey(0)  # 添加按键等待，避免窗口一闪而过
cap.release()
cv2.destroyAllWindows()

内容的提问来源于stack exchange，提问作者Poco X3 Pro