Python构建带CUDA的OpenCV.exe后出现ImportError: DLL load failed求助

问题根源 #

源码编译的带CUDA的OpenCV依赖大量CUDA相关动态库，Pyinstaller、Nuitka这类打包工具默认不会自动抓取非标准路径下的DLL，导致运行exe时找不到依赖模块。

解决步骤 #

1. 手动补充依赖DLL #

• 找到CUDA Toolkit安装目录下的bin文件夹（例：C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\bin），复制所有.dll文件
• 找到OpenCV编译输出的bin\Release目录（例：D:\opencv-build\bin\Release），复制所有.dll文件
• 将上述所有DLL放到打包生成的.exe所在的同一文件夹内

2. Pyinstaller打包时指定DLL路径 #

在打包命令中通过--add-binary参数直接引入所需DLL：

pyinstaller --onefile --add-binary "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\bin\*.dll;." --add-binary "D:\opencv-build\bin\Release\*.dll;." your_script.py

注意替换命令中的实际路径，v11.7需改成你的CUDA版本号，opencv-build替换为你的编译输出目录

3. 脚本中指定OpenCV路径 #

在Python脚本开头添加以下代码，确保运行时能定位到正确的OpenCV库：

import sys
import os

# 添加OpenCV编译后的bin目录到系统路径
sys.path.append(r"D:\opencv-build\bin\Release")
# 更新环境变量PATH，优先加载指定目录的DLL
os.environ['PATH'] = r"D:\opencv-build\bin\Release;" + os.environ['PATH']

import cv2

4. Nuitka打包配置 #

使用Nuitka时，通过--include-data-files参数引入DLL：

nuitka --standalone --include-data-files="C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\bin\*.dll=." --include-data-files="D:\opencv-build\bin\Release\*.dll=." your_script.py

5. 目标机器环境检查 #

如果要在其他机器运行exe，需确保目标机器安装了和编译时同版本的CUDA Runtime，或者直接把CUDA Runtime的DLL打包进去（即步骤1中收集的文件）

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