PyInstaller单文件打包PySide6程序Win7运行失败求助

问题描述 #

使用PyInstaller --onefile 选项在Windows 11上打包PySide6应用程序，本地运行正常，但在Windows 7上启动时出现以下错误：

qt.qpa.plugin: Could not load the Qt platform plugin "windows" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
Available platform plugins are: direct2d, minimal, offscreen, windows.

已尝试将包含.dll文件的platform文件夹放在可执行文件旁，问题未解决。

解决方案 #

1. 强制指定Qt平台插件加载路径 #

在主程序test_MWE.py开头添加代码，适配OneFile模式下的临时解压路径：

import os
import sys

# 适配OneFile模式的Qt插件路径
if hasattr(sys, '_MEIPASS'):
    # 打包后运行时，指向临时目录中的插件路径
    os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = os.path.join(sys._MEIPASS, 'PySide6', 'plugins', 'platforms')
else:
    # 开发环境下，指向PySide6安装目录的插件路径
    from PySide6 import QtCore
    os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = os.path.join(os.path.dirname(QtCore.__file__), 'plugins', 'platforms')

# 原有的导入和代码
from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton, QLineEdit, QFileDialog
from test_app import Ui_MainWindow

2. 修改Spec文件，确保平台插件被完整打包 #

编辑test_MWE.spec，在Analysis的datas字段中添加Qt平台插件的打包规则：

a = Analysis(
    ['test_MWE.py'],
    pathex=[],
    binaries=[],
    # 替换为你的Python安装路径，确保指向PySide6的platforms文件夹
    datas=[(r'C:\Python310\Lib\site-packages\PySide6\plugins\platforms', 'PySide6/plugins/platforms')],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)

3. 禁用UPX压缩或排除Qt相关DLL #

Windows 7对UPX压缩的二进制兼容性较差，修改EXE部分的配置：

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.zipfiles,
    a.datas,
    [],
    name='test_MWE',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    # 直接禁用UPX
    upx=False,
    # 或保留UPX但排除Qt平台插件DLL
    # upx=True,
    # upx_exclude=['qwindows.dll', 'qdirect2d.dll'],
    runtime_tmpdir=None,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)

4. 安装Windows 7必要依赖 #

• 安装Visual C++ Redistributable for Visual Studio 2019（x86/x64对应你的程序架构）
• 安装Windows 7补丁KB2533623，用于支持SHA-2签名的二进制文件（现代Qt DLL使用该签名，Windows 7默认不支持）

5. 强制指定Qt运行平台 #

在QApplication初始化前添加环境变量，强制使用windows平台插件：

if __name__ == "__main__":
    # 强制指定Qt平台为windows
    os.environ['QT_QPA_PLATFORM'] = 'windows'
    app = QApplication(sys.argv)

    window = MainWindow()
    window.show()

    window.ui.run.clicked.connect(showMessage)

    sys.exit(app.exec())

验证步骤 #

1. 保存修改后的代码和spec文件
2. 使用PyInstaller重新打包：pyinstaller test_MWE.spec
3. 将生成的可执行文件复制到Windows 7测试运行

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