PyInstaller打包后OpenCV imread()循环中突然停滞的问题求助

我之前遇到过类似的打包后OpenCV文件读取异常的情况，结合你的排查信息，给你几个针对性的解决方向：

1. 优先排查文件句柄泄漏问题 #

Windows系统的文件句柄数量是有限的，虽然cv2.imread()理论上会自动释放文件资源，但打包后的环境（尤其是PyInstaller对依赖的封装）可能导致句柄没有被正确回收。几千次迭代后耗尽句柄，就会出现文件读取卡住的情况。

建议替换imread为**显式读取文件+imdecode**的方式，手动控制文件资源的释放：

import numpy as np
import os

# 替换原有的frame = cv2.imread(imgpath)部分
try:
    # 显式打开并读取文件，with块会自动关闭文件句柄
    with open(imgpath, 'rb') as f:
        img_bytes = f.read()
    # 转成numpy数组再解码
    nparr = np.frombuffer(img_bytes, np.uint8)
    frame = cv2.imdecode(nparr, cv2.IMREAD_COLOR)
except Exception as e:
    print(f"Debug - 文件读取异常: {e}, frameNum = {CurrFrameNum}", flush=True)
    time.sleep(0.1)

2. 修复PyInstaller的OpenCV依赖打包问题 #

PyInstaller有时候会漏掉OpenCV的底层依赖文件（比如图像解码相关的DLL），导致长时间运行后出现资源异常。

• 打包时添加--collect-all参数，强制收集OpenCV的所有依赖：

  pyinstaller --collect-all opencv-python your_script.py
  

• 手动补充FFmpeg解码库：找到你的Python环境中OpenCV安装目录下的opencv_videoio_ffmpeg*.dll文件，复制到打包后的exe同目录下。很多图像/视频解码异常都是因为这个库被遗漏。

3. 缓解线程调度与GIL阻塞问题 #

虽然你的线程显示存活，但imread的底层C调用可能长时间持有GIL（全局解释器锁），导致Windows线程调度异常，看起来像是卡住。

• 在读取循环中加入微小延迟，给线程释放GIL的机会：

  while not self.isStopTask:
      # ... 原有代码 ...
      frame = cv2.imread(imgpath)
      print("Debug - 3",flush=True)
      # 添加微小延迟
      time.sleep(0.001)
      # ... 后续处理 ...
  

• 考虑用多进程替代线程：把帧读取逻辑放到单独的进程中，通过队列传递帧数据。多进程不受GIL限制，能避免线程间的调度阻塞问题。

4. 排查磁盘IO与文件缓存异常 #

Windows的文件系统缓存在批量读取大量小文件后，可能出现异常导致读取卡住。

• 读取前先校验文件的可访问性：

  imgpath = abspath( join(self.src,str(CurrFrameNum)+".jpg"))
  print("Debug - 2",flush=True)
  # 先检查文件是否存在且可读
  if not os.path.exists(imgpath) or not os.access(imgpath, os.R_OK):
      print(f"Debug - 文件不可访问: {imgpath}", flush=True)
      time.sleep(0.1)
      continue
  # 再执行读取操作
  frame = cv2.imread(imgpath)
  

建议先尝试第一种方法（显式读取文件+imdecode），这是这类打包后文件读取卡住问题的最常见解决手段。如果还是不行，再依次排查依赖和线程调度的问题。

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