该错误的核心是 PyInstaller 打包的应用程序在运行时，其运行时钩子 `pyi_rth_multiprocessing` 在执行过程中，尝试导入 `_socket` 模块时，相关的动态链接库（DLL）加载失败 [ref_5]。这通常与 Python 解释器、Windows 系统版本及多进程模块的兼容性有关。 **问题根因分析** | 可能原因 | 具体说明 | | :--- | :--- | | **Windows 系统缺少关键更新** | 在 Windows 7 及部分早期 Windows 10 系统上，Python 3.7+ 版本的多进程模块依赖于一个名为 `msvcp140.dll` 的 C 运行时库，而该库的完整功能需要系统安装 **KB2533623** 补丁。若系统未安装此补丁，会导致 `_socket` 等底层模块的 DLL 加载失败 [ref_5]。 | | **Python 环境或 PyInstaller 版本问题** | 使用的 Python 解释器环境（如 Anaconda、Miniconda）可能存在 DLL 路径混乱或版本冲突。PyInstaller 在打包时未能正确收集或定位到 `_socket.pyd` 及其依赖的 DLL 文件 [ref_1][ref_3]。 | | **防病毒软件或系统权限干扰** | 在某些情况下，防病毒软件可能会误判或阻止打包后的 exe 文件加载必要的 DLL，或者用户权限不足导致无法访问临时解压目录中的 DLL 文件。 | **解决方案** 请按以下顺序尝试，通常方案一能解决大部分 Windows 7 环境下的问题。 ### 方案一：为 Windows 7 系统安装关键更新补丁 (KB2533623) 这是针对 Windows 7 系统最根本的解决方案。 1. **确认系统版本**：在运行窗口输入 `winver`，确认你的操作系统是 Windows 7。 2. **下载并安装补丁**： * 前往微软官方下载中心或通过 Windows Update 搜索并安装 **KB2533623** 补丁。 * 安装完成后，**务必重启计算机**。 3. **验证**：重启后，再次运行之前打包的 exe 程序，检查错误是否消失。 如果无法安装此补丁，或系统已是 Windows 10/11，请尝试方案二。 ### 方案二：降级 Python 版本至 3.6.x Python 3.6 版本的多进程模块对系统补丁的依赖较低，兼容性更好。 ```bash # 建议使用虚拟环境管理工具（如 conda 或 venv）创建一个新的 Python 3.6 环境 conda create -n py36 python=3.6 conda activate py36 # 在新环境中重新安装项目依赖和 PyInstaller pip install -r requirements.txt pip install pyinstaller # 重新打包你的程序 pyinstaller -F -w your_script.py ``` ### 方案三：在 PyInstaller 命令中显式排除或处理多进程钩子 尝试告诉 PyInstaller 以另一种方式处理多进程。 ```bash # 使用 --exclude-module 尝试排除可能引起问题的模块（效果因项目而异） pyinstaller -F -w --exclude-module _socket your_script.py # 或者，使用 --hidden-import 确保多进程相关模块被显式导入 pyinstaller -F -w --hidden-import multiprocessing --hidden-import multiprocessing.spawn your_script.py ``` ### 方案四：检查并修复 Python 环境及 DLL 依赖 适用于所有系统，特别是使用 Anaconda 等集成环境的情况。 1. **检查 DLL**：在 Python 安装目录下（如 `C:\Python39\DLLs` 或 `C:\Users\<用户名>\Anaconda3\DLLs`），查找 `_socket.pyd` 文件。确保其存在。 2. **复制缺失的 DLL**：根据其他类似错误的解决经验，有时需要手动将缺失的运行时 DLL（如 `msvcp140.dll`, `vcruntime140.dll`）从系统目录或 Python 目录复制到打包输出目录的根目录下 [ref_4]。这些文件通常位于 `C:\Windows\System32` 或 Python 安装目录的根目录下。 3. **使用 Dependency Walker**：使用工具（如 `Dependency Walker`）打开打包后的 exe 或 `_socket.pyd`，分析具体缺失哪个 DLL 文件，然后手动补齐。 ### 方案五：以管理员身份运行并关闭防病毒软件 1. 右键点击打包生成的 exe 文件，选择“以管理员身份运行”。 2. 临时关闭 Windows Defender 实时保护或第三方防病毒软件，再运行 exe 测试。如果此时能正常运行，则需将你的 exe 文件添加到防病毒软件的信任列表中。 **总结与建议** 最可能的原因是目标运行环境（尤其是 Windows 7）缺少微软运行库更新 [ref_5]。**首选方案一（安装 KB2533623 补丁）**，若不可行则采用**方案二（降级 Python 至 3.6）**。若问题出现在 Windows 10/11，则重点排查**方案四（DLL 依赖）**。在开发机上，确保使用干净的虚拟环境进行打包，可以有效减少因环境混乱导致的问题 [ref_1][ref_3]。