PyInstaller打包程序Windows10与Windows8.1兼容问题求助

我在Windows 10系统上用PyInstaller打包了一个独立应用，在所有Win10设备上都能正常运行，但放到Windows 8.1上就无法启动。使用的打包命令如下：

pyinstaller -F -w --onefile file_name.py

添加--debug参数编译后，调试日志最后出现报错：

[2792] LOADER: Installing PYZ archive with Python modules. Failed to execute [FILE_NAME]

另外我的代码里包含这段Selenium等待逻辑：

WebDriverWait(driver,10000).until(EC.visibility_of_element_located((By.TAG_NAME,'body')))

想请教下能不能通过设置兼容性，让应用在多版本Windows上通用？需要修改打包参数还是Python代码？

从调试日志来看，问题出在加载PYZ归档文件的环节，结合Win10与Win8.1的系统组件差异，核心是兼容性配置和依赖环境的问题，下面给你几个可行的解决方向：

1. 给PyInstaller添加兼容性配置（最关键） #

Win8.1和Win10的系统底层组件存在差异，你可以通过**指定应用程序清单（manifest）**强制声明应用支持的Windows版本，或者调整PyInstaller的打包参数：

方法1：自定义manifest文件 #

创建一个名为app.manifest的文件，内容如下，明确声明支持Win8.1及以上版本：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
        <application>
            <!-- Windows 10 -->
            <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>
            <!-- Windows 8.1 -->
            <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}"/>
            <!-- Windows 8 -->
            <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>
        </application>
    </compatibility>
    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
        <security>
            <requestedPrivileges>
                <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
            </requestedPrivileges>
        </security>
    </trustInfo>
</assembly>

然后用这个manifest文件重新打包：

pyinstaller -F -w --onefile --manifest=app.manifest file_name.py

方法2：使用PyInstaller的私有组件参数 #

添加--win-private-assemblies参数，让应用使用打包时嵌入的私有系统组件，避免依赖目标系统中缺失的组件：

pyinstaller -F -w --onefile --win-private-assemblies file_name.py

2. 检查Python和依赖库的兼容性 #

• Python版本：确保你打包用的Python版本支持Windows 8.1。Python 3.11及以上版本已不再支持Win8.1，如果你用的是3.11+，建议降级到Python 3.10（最后一个支持Win8.1的正式版）。
• Selenium与WebDriver版本：你的代码用到了Selenium，要确保ChromeDriver/GeckoDriver的版本不仅兼容你的浏览器，还支持Win8.1。比如Chrome 109及以上版本不再支持Win8.1，所以要对应使用Chrome 108及以下版本，以及匹配的Driver。

3. 代码层面的兼容优化（非核心但更稳妥） #

你的WebDriverWait代码本身没问题，但可以增加异常捕获，同时确保Driver初始化时添加Win8.1兼容的配置，比如ChromeDriver可以添加：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
# 针对Win8.1的兼容配置，解决可能的权限或资源问题
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage")
driver = webdriver.Chrome(options=options)

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