[Python] ImportError: DLL load failed … 找不到指定的模块 此类问题解决方法

文章目录

问题

最近升级 Python 项目，由 Python2.7 升级到 Python3.8.3 ，项目使用了 PySide2 ，对于较新的 Python3.8.3 , PySide2 可能存在些许不兼容问题，环境配置完成后，出现一连串的

ImportError: DLL load failed 找不到指定模块

对于很多 Python 开发者来说，这类问题最为头疼，不知道如何下手解决。

我是在 virtualenv 虚拟环境下配置 Python3.8.3 的开发环境。

• OS： Windows 7 x64
• Python: 3.8.3

各种依赖安装完毕后，运行项目，首先报出的是

from .shiboken2 import *

ImportError: DLL load failed while importing shiboken2: 找不到指定的模块

定位

从提示上看，是加载 DLL 失败，是关于 shiboken2 模块的。

第一反应是，这个库用到了某个 DLL， DLL 所在路径没有加到虚拟环境的变量 path 中。

于是打开 shiboken2 的包目录查找，看到有一些 DLL 文件：

首先尝试把它们复制到 Python 虚拟环境的 Scripts 目录下。依然不行，看来路径正确还是不行，或许是缺少其它依赖的 DLL，网上下载、打开 DLL 依赖检查工具 Dependency Walker ，将 shiboken2.pyd 拖入这个工具中，发现缺少 python3.dll 依赖：

原来，在创建 Python3.8.3 虚拟环境时，只自动复制了 python38.dll 到 Scripts 目录，没有 python3.dll ，于是手动复制 python3.dll 到虚拟环境的 Scripts 目录。再次运行项目，果然上面错误没有了。但报了另外一个错误：

from PySide2.QtCore import QObject, QSettings

ImportError: DLL load failed while importing QtCore: 找不到指定的模块

继续使用 Dependency Walker ，打开 PySide2 包目录下的 QtCore.pyd ，发现缺少几个 DLL 文件：

网上搜索并下载缺失的 DLL 文件，放到 Scripts 目录，再次运行项目，错误消失啦。

结论

Dependency Walker 真香！

补充

有时还会遇到 %1 不是有效的 win32 程序 这种对python开发者来说也是比较摸不着头脑的。

通常这个问题都是由于某个包内的 pyd 或 dll 与 python 的版本(x86/x64)不匹配。如何查看 pyd 或 dll 是多少位的？Windows 下使用 dumpbin.exe 工具（安装了VS2019才有，或者网上下载吧）。

比如我遇到的：安装了 PyQt5 后，导入 PyQt5时，报错： sip 不是有效的 win32 程序。

dumpbin.exe /HEADERS sip.pyd

执行后发现 sip.pyd 是x86的（32位），而我的Python是64位，而且其他装好的的QtGui.pyd, QtCore.pyd 等等都是 64位，难怪不匹配。只有sip.pyd 是 32 位，不清楚这情况是如何造成的。

于是 pip uninstall 了 PyQt5_sip，pip 重新安装 ，版本正确了，错误消失了

68747470:733a2f2f626c6f672e6373646e2e6e65742f776e303131322f:61727469636c652f64657461696c732f313037343839333933