运行人脸识别考勤系统遇OpenCV文件读取错误，求详细排查

1. 模型文件路径错误 #

• 检查代码中加载模型的路径是否准确：
  • 优先使用绝对路径，比如C:/attendance_system/trained_model.yml（Windows）或/home/yourname/attendance/trained_model.yml（Linux/macOS），避免相对路径的工作目录偏差问题
  • 若用相对路径，确认运行代码的终端/IDE工作目录和模型文件所在目录一致，比如模型在attendance/models下，代码里要写models/trained_model.yml
  • 注意路径斜杠：Windows下代码里要写\\或直接用/，同时区分文件名大小写（Linux/macOS系统严格区分）

2. 模型文件不存在或损坏 #

• 确认指定路径下确实存在对应模型文件（通常是.yml/.xml格式），如果是自行训练的模型，检查训练代码是否正常生成了有效文件
• 若为下载的预训练模型，重新下载一次，避免文件因中断下载导致损坏

3. OpenCV版本冲突或不兼容 #

• 先核实实际安装的OpenCV版本：运行import cv2; print(cv2.__version__)，错误提示显示的是4.1.2，但你说用的是4.1.12，可能存在版本冲突
• 确保opencv-python和opencv-contrib-python版本完全一致，版本不匹配会导致人脸识别模块功能异常：
  • 卸载现有库：pip uninstall opencv-python opencv-contrib-python
  • 重新安装同版本：pip install opencv-python==4.1.2 opencv-contrib-python==4.1.2（若需4.1.12，先确认PyPI仓库是否提供该版本）

4. 文件权限问题 #

• Windows：确认模型文件未被其他程序占用，且你拥有该文件的读取权限（避免放在C:\Windows等系统保护目录）
• Linux/macOS：给模型文件添加读取权限，执行命令chmod +r /path/to/your/model.yml

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