OpenCV调用haarcascade文件报错：无法以读模式打开.xml文件

这个错误的核心是OpenCV找不到你指定的XML文件路径，以下是具体解决办法：

1. 核对文件路径与命名 #

• 若XML文件和Python脚本在同一文件夹，检查文件名拼写（注意Linux/macOS区分大小写），确保是haarcascade_frontalface_default.xml，无多余空格或错误后缀。
• 若文件不在脚本同目录，使用绝对路径加载，示例：

  import cv2
  # Windows系统路径（用双反斜杠或原始字符串）
  data = cv2.CascadeClassifier('C:\\opencv_data\\haarcascades\\haarcascade_frontalface_default.xml')
  # Linux/macOS系统路径
  data = cv2.CascadeClassifier('/home/user/opencv_data/haarcascades/haarcascade_frontalface_default.xml')
  

2. 调用OpenCV自带的haarcascade文件 #

多数OpenCV安装包自带该检测文件，可通过代码自动定位路径：

import cv2
import os

# 获取OpenCV安装目录
cv2_base_dir = os.path.dirname(os.path.abspath(cv2.__file__))
# 拼接官方haarcascade文件路径
cascade_path = os.path.join(cv2_base_dir, 'data', 'haarcascade_frontalface_default.xml')
data = cv2.CascadeClassifier(cascade_path)

3. 修复或重新获取XML文件 #

• 手动打开XML文件，确认文件未损坏、内容非空。
• 若文件损坏，重新下载官方原版的haarcascade_frontalface_default.xml，保存到指定路径后再尝试加载。

4. 排查文件权限问题 #

Linux/macOS系统下，若脚本无读取文件的权限，执行以下命令调整：

chmod +r haarcascade_frontalface_default.xml

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