使用OpenCV的CascadeClassifier时遭遇PyInstaller打包异常

我之前也踩过PyInstaller打包OpenCV分类器的坑，你的问题核心其实是打包后资源路径没有正确映射——IDE里运行正常是因为工作目录就是项目根目录，但单文件打包后程序会解压到系统临时目录，原来的相对路径直接失效了。另外报错里的D盘路径是OpenCV编译时的路径，不是你的问题，真正的触发点是_face_cascade其实是空的，只是加载时没抛出清晰错误，直到调用detectMultiScale才触发!empty()断言，容易误导排查方向。

问题原因拆解 #

• PyInstaller单文件打包后，所有资源会被解压到sys._MEIPASS指向的临时目录，而非你运行exe的目录，原相对路径找不到文件
• 你用的--add-data参数在Windows下应该用分号分隔，冒号是类Unix系统的格式，可能导致资源没有被正确打包进去
• cv2.CascadeClassifier加载失败时不会立即抛出明确错误，直到调用检测函数才触发断言，增加了排查难度

解决方案（亲测有效） #

1. 修改代码，动态获取资源路径 #

在代码里添加一个工具函数，自动适配开发环境和打包后的环境：

import sys
import os
import cv2

def get_resource_path(relative_path):
    """获取资源的绝对路径，适配开发/打包两种环境"""
    try:
        # 打包后，PyInstaller会设置这个变量指向临时解压目录
        base_path = sys._MEIPASS
    except Exception:
        # 开发环境下，用当前脚本的目录作为基准
        base_path = os.path.dirname(os.path.abspath(__file__))
    return os.path.join(base_path, relative_path)

# 加载分类器时使用这个函数获取路径
_face_cascade = cv2.CascadeClassifier(get_resource_path('cascade_data/haarcascade_frontalface_default.xml'))

# 新增校验：确保分类器加载成功，提前排查问题
if _face_cascade.empty():
    raise RuntimeError(f"分类器加载失败！请检查路径：{get_resource_path('cascade_data/haarcascade_frontalface_default.xml')}")

2. 修正PyInstaller打包命令（Windows环境） #

Windows下--add-data的分隔符是分号，不是冒号，修改打包命令：

pyinstaller --onefile --windowed --add-data "face_recognition_models;face_recognition_models" --add-data "cascade_data;cascade_data" Ejecutable.py

3. 可选：先用onedir模式排查问题 #

如果还是遇到问题，可以先去掉--onefile参数，用--onedir模式打包，这样资源会直接放在输出的dist/Ejecutable目录下，你可以直观看到cascade_data文件夹是否存在、xml文件是否正确，确认路径没问题后再改回--onefile。

内容的提问来源于stack exchange，提问作者ivan cast.