PyInstaller打包PyQt5应用运行报错：ImportError: DLL加载失败

问题分析 #

报错ImportError: DLL load failed while importing QtWidgets: The specified procedure could not be found，核心原因是Qt相关DLL未正确打包、环境存在PyQt5/PyQt6冲突，或是.spec文件冗余配置导致路径查找混乱。

具体修复步骤 #

1. 清理.spec文件的冗余配置

你的.spec文件存在两处关键问题：

• hiddenimports中混入了PyQt6相关模块（你实际依赖的是PyQt5），同时包含pandas、sqlalchemy等未使用的依赖，需全部删除；datetime是Python标准库，无需手动声明。
• pathex添加了过多系统级路径，会干扰PyInstaller的自动依赖查找逻辑，仅保留项目根目录即可。

修改后的Analysis段代码：

a = Analysis(
    ['main.py'],
    pathex=['C:\\Users\\user\\Desktop\\am_gui'],  # 仅保留项目目录
    binaries=[],
    datas=[],
    hiddenimports=['matplotlib.backends.backend_qt5agg', 'numpy'],  # 仅保留实际需要的非自动检测依赖
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=['PyQt6', 'PyQt6.QtCore', 'PyQt6.QtWidgets'],  # 明确排除PyQt6避免版本冲突
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)

2. 手动添加Qt5核心二进制文件

PyInstaller有时会遗漏Qt的关键DLL，需在binaries参数中明确指定Qt5的bin目录：

binaries=[('C:\\Users\\user\\anaconda3\\Lib\\site-packages\\PyQt5\\Qt5\\bin\\*.dll', 'PyQt5\\Qt5\\bin')],

这会将Qt5 bin目录下的所有DLL复制到打包后的对应路径，确保运行时能找到依赖。

3. 环境检查与依赖修复

• 检查当前环境是否同时安装了PyQt5和PyQt6：执行pip list | findstr PyQt，若存在PyQt6则卸载：pip uninstall PyQt6 PyQt6-Qt6
• 强制重装核心依赖确保完整性：pip install --force-reinstall PyQt5 matplotlib numpy

4. 重新构建应用

• 删除旧的build和dist目录，避免残留文件干扰
• 用修改后的.spec重新打包：pyinstaller main.spec
• 运行dist/main/main.exe测试

额外提示 #

• 若仍有缺失模块警告，可通过pyi-makespec --hidden-import=模块名 main.py生成全新.spec文件，再基于此调整配置
• 尽量避免手动添加系统级路径，PyInstaller会自动遍历当前环境的依赖目录

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