ImportError: DLL load failed while importing onnxruntime_pybind11_state: 动态链接库(DLL)初始化例程失败。问题解决办法

最新推荐文章于 2025-03-20 20:20:10 发布

Au237

最新推荐文章于 2025-03-20 20:20:10 发布

阅读量4.7k

点赞数 19

文章标签：计算机视觉深度学习 ocr

本文链接：https://blog.csdn.net/2403_87153858/article/details/146254445

版权

在运行第三方库时的常见报错。ONNX Runtime（ORT）是由微软开发的开源推理引擎，支持跨平台、多硬件加速（CPU/GPU）。它能够高效运行 ONNX 格式的模型，广泛应用于模型部署、边缘计算等场景。

1.反复安装卸载无效

用户在使用 import onnxruntime 时遇到以下错误：

from .onnxruntime_pybind11_state import *  # noqa
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ImportError: DLL load failed while importing onnxruntime_pybind11_state: 动态链接库(DLL)初始化例程失败。

初步尝试：

通过 pip uninstall onnxruntime 彻底卸载库。
重新安装最新版本：pip install onnxruntime。
多次重复上述步骤，问题依旧。

2.安装 Visual C++ 2019 可再发行组件包

使用搜索引擎排查错误，得知可能是由DLL 初始化失败可能与系统运行时库缺失有关，尝试安装 Microsoft Visual C++ 2019 Redistributable：

从微软官网下载并安装 VC++ 2019 可再发行组件包。
重启系统再次尝试

pip install onnxruntime  
python -c "import onnxruntime"

错误依然存在，表明问题并非由 VC++ 运行时库缺失直接导致。

3.查阅官方文档

onnxruntime库官方文档查阅后，怀疑是否与 CUDA 相关依赖缺失有关。尝试安装 GPU 版本：

pip install onnxruntime-gpu

安装成功后尝试调用onnxruntime-gpu库，报错消失。

到这里原问题已经解决，但产生了一个新问题——与其他第三方库出现兼容性冲突。

是的在调用其他三方库时又产生了新报错，例如：

AttributeError: module 'onnxruntime' has no attribute 'set_default_logger_severity'

安装 GPU 版本虽然修复了 DLL 问题，但与第三方库不兼容。

4.Python 虚拟环境与版本降级

问题当然不是出在CUDA上，于是怀疑onnxruntime库的报错问题与python环境版本相关，决定通过 Anaconda 的虚拟环境机制解决问题。这里尝试使用python3.9.19版本

安装 Anaconda（如未安装）：
从 Anaconda 官网下载并安装适合操作系统的版本。
创建独立环境：
打开 Anaconda Prompt 或终端，执行以下命令创建指定 Python 版本的环境
```
conda create -n onnxruntime python=3.9.19  
```
激活环境：
```
conda activate onnxruntime
```
安装 CPU 版 ONNX Runtime：
```
pip install onnxruntime  
```
验证导入：这时我们再安装第三方库尝试运行，发现程序运行正常。