如何解决ImportError: DLL加载失败无法导入cv2的问题？

已尝试的操作 #

• 检查OpenCV安装状态与路径，执行pip3 show opencv-python确认存在，输出如下：

PS C:\Users\Koushkv> pip3 show opencv-python
Name: opencv-python
Version: 4.8.0.74
Summary: Wrapper package for OpenCV python bindings.
Home-page: https://github.com/opencv/opencv-python
Author:
Author-email:
License: Apache 2.0
Location: C:\Users\Koushkv\AppData\Local\Programs\Python\Python311\Lib\site-packages

• 升级OpenCV，确认已是最新版本
• 升级Windows系统至最新版本

尚未尝试的操作 #

• 卸载重装OpenCV（因集成CUDA，重装耗时，希望先排查其他方案）

报错信息 #

导入cv2时触发如下错误：

PS C:\Users\Koushkv> py
Python 3.11.3 (tags/v3.11.3:f3909b8, Apr  4 2023, 23:49:59) [MSC v.1934 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import cv2
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "C:\Users\Koushkv\AppData\Local\Programs\Python\Python311\Lib\site-packages\cv2\__init__.py", line 181, in <module>
    bootstrap()
  File "C:\Users\Koushkv\AppData\Local\Programs\Python\Python311\Lib\site-packages\cv2\__init__.py", line 153, in bootstrap
    native_module = importlib.import_module("cv2")
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Koushkv\AppData\Local\Programs\Python\Python311\Lib\importlib\__init__.py", line 126, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ImportError: DLL load failed while importing cv2: The specified module could not be found.

无需重装OpenCV的解决办法 #

1. 排查缺失的依赖DLL

   • 找到OpenCV安装目录下的cv2.pyd文件（路径：C:\Users\Koushkv\AppData\Local\Programs\Python\Python311\Lib\site-packages\cv2）
   • 使用VS Build Tools的dumpbin工具执行命令：dumpbin /dependents 路径\cv2.pyd，查看输出中标记为缺失的DLL，手动补充或修复这些依赖

2. 调整系统环境变量

   • 将OpenCV的DLL目录（如...\site-packages\cv2\python-3.11或直接是...\site-packages\cv2）添加到系统PATH环境变量
   • 重启终端和Python解释器后，再次尝试导入cv2

3. 确认Python环境一致性

   • 执行where py和where pip3，确保两个命令指向的Python解释器路径一致，避免跨环境安装/调用的问题
   • 若使用虚拟环境，确认已激活对应环境后再执行导入操作

4. 修复CUDA相关依赖

   • 检查CUDA Toolkit版本与OpenCV 4.8.0的兼容性（推荐CUDA 11.7-12.1）
   • 确认CUDA的bin目录已添加到系统PATH，且目录下的核心DLL（如cudart64_110.dll或对应版本文件）完整存在

5. 快速修复OpenCV文件

   • 执行命令pip3 install --force-reinstall --no-deps opencv-python，该命令会重新安装OpenCV但不会重新下载依赖包，耗时远低于完全重装，可保留CUDA集成配置

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