Python中cv2模块导入DLL加载失败问题排查与解决

一、定位缺失的DLL文件 #

• 使用Dependency Walker工具：找到cv2的核心pyd文件（路径示例：C:\Users\Administrator\AppData\Local\Programs\Python\Python311\Lib\site-packages\cv2\python-3.11\cv2.pyd），将其拖入Dependency Walker工具，工具会高亮显示无法找到的依赖DLL。
• 用Python脚本排查：运行以下代码，捕获加载时的详细错误信息：

import ctypes
try:
    ctypes.WinDLL("C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python311\\Lib\\site-packages\\cv2\\python-3.11\\cv2.pyd")
except Exception as e:
    print(f"加载错误：{e}")

• 检查环境变量：确认Python的Scripts目录、cv2的安装目录已加入系统PATH环境变量，避免系统无法找到依赖DLL。

二、解决方法 #

• 安装对应版本的VC++ Redistributable：OpenCV依赖微软VC运行库，根据Python版本（如Python3.11需VC 2019/2022 Redistributable），下载安装匹配的x86/x64版本。
• 更换兼容的OpenCV版本：若当前opencv-python版本与Python3.11不兼容，执行指定版本安装命令：

pip install opencv-python==4.7.0.72

• 补充缺失的DLL文件：若已定位到具体缺失的DLL（如opencv_worldxxx.dll或系统DLL），从正常运行的机器复制对应文件，放到C:\Windows\System32（64位系统）、C:\Windows\SysWOW64（32位系统），或cv2.pyd文件的同级目录。
• 核对Python与OpenCV位数：确保Python和安装的opencv-python同为64位或32位，位数不匹配会直接导致DLL加载失败。

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