Windows XP 32位机导入cv2遇ImportError: DLL加载失败问题求助

这种跨老旧工业机的DLL依赖问题我之前帮同事排查过，给你列几个针对性的步骤，你可以逐一尝试：

1. 先确保打包环境的架构完全匹配 #

你当前是在64位Windows8上开发，但目标机是32位XP，这是核心隐患之一：

• 如果你的Python2.7是64位版本，打包出来的exe会依赖64位的OpenCV DLL和系统组件，32位XP根本无法加载。必须换成32位的Python2.7，重新搭建开发环境。
• 安装对应版本的32位OpenCV3.4：注意OpenCV 3.4后期版本已经放弃XP支持，推荐安装opencv-python==3.4.1.15（这个版本是最后几个支持XP的3.4.x版本），用命令pip install opencv-python==3.4.1.15安装。
• 重新在这个32位环境下测试你的Python脚本，确认能正常运行后，再用Pyinstaller打包。

2. 排查并补充缺失的DLL #

XP系统缺少很多新系统自带的组件，即使你装了微软组件，可能版本不对：

• 安装VC++ 2008 SP1 Redistributable Package (x86)：Python2.7是用VC2008编译的，必须装这个版本的运行库，更高版本的VC运行库不兼容Python2.7的依赖。
• 用Dependency Walker（depends.exe）打开你的exe，查看具体缺失的DLL：注意Dependency Walker在XP上可能会误报一些api-ms-win-*系列的系统DLL，重点关注OpenCV相关的DLL（比如opencv_world341.dll）和VC++运行库文件（比如msvcr90.dll）。
• 手动复制OpenCV的核心DLL到exe所在文件夹：找到32位Python环境下Lib\site-packages\cv2目录里的OpenCV DLL，直接复制到exe同目录，Pyinstaller有时候会漏掉这些非标准依赖。

3. 调整Pyinstaller打包参数 #

优化打包过程，确保所有依赖都被正确打包：

• 打包时加上--win-private-assemblies参数，强制把所有私有依赖打包进exe，避免依赖系统自带的DLL：

  pyinstaller --win-private-assemblies your_script.py
  

• 如果是单文件打包（--onefile），XP兼容性较差，建议先打包成文件夹模式（去掉--onefile），这样更容易排查DLL缺失问题。
• 用--add-data手动指定OpenCV DLL的路径，确保被打包：

  pyinstaller --add-data "C:\Python27_x86\Lib\site-packages\cv2\opencv_world341.dll;." your_script.py
  

4. 确认OpenCV对XP的兼容性 #

• 避免使用OpenCV 3.4.2及以后的版本，这些版本已经移除了对XP的支持。坚持用3.4.1或更早的3.4.x版本。
• 如果你的项目用到了OpenCV contrib模块，建议暂时移除，因为contrib里的部分模块依赖的第三方库可能不兼容XP。

5. XP系统的额外配置 #

• 确保XP SP3已经安装了所有关键补丁，尤其是KB976932（SP3的核心更新），很多新的DLL依赖这个补丁才能正常工作。
• 把exe所在的文件夹添加到系统的PATH环境变量中，确保系统能找到所有依赖的DLL。

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