使用PyInstaller签名含QWebEngineView的应用时出现行为差异

嘿，我之前也碰到过类似的问题，PyInstaller签名后QWebEngineView出现行为差异，大概率是签名过程影响了Chromium内核的运行环境或者权限配置，咱们一步步来排查和解决：

可能的核心原因 #

• 权限/沙箱限制：QWebEngine依赖Chromium内核，签名时如果开启了严格的沙箱规则，会限制它的网络访问、JIT编译等核心能力，导致加载网页异常。
• 资源文件丢失：签名过程可能意外修改了打包后的文件结构，使得QWebEngine需要的Chromium二进制文件、本地化资源无法被正确找到。
• 签名配置缺失：尤其是macOS下，缺少必要的entitlements权限配置，会直接导致Chromium无法正常初始化。

具体解决方案 #

1. 先确保PyInstaller打包配置正确

建议用.spec文件来精细化配置打包，避免命令行打包的遗漏。针对你的测试脚本tester.py，可以生成并修改如下.spec文件：

# -*- mode: python ; coding: utf-8 -*-

block_cipher = None

a = Analysis(
    ['tester.py'],
    pathex=[],
    binaries=[],
    datas=[],
    # 显式声明QWebEngine的隐藏依赖，避免打包遗漏
    hiddenimports=['PySide6.QtWebEngineCore', 'PySide6.QtWebEngineWidgets'],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)
pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.zipfiles,
    a.datas,
    [],
    name='tester',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=True,  # GUI应用可以改成False
    disable_windowed_traceback=False,
    target_arch=None,
    codesign_identity=None,  # 先不打包时签名，后续单独处理
    entitlements_file=None,
)

执行打包：pyinstaller tester.spec，先确认未签名的应用能正常运行，排除打包本身的问题。

2. macOS平台：配置正确的签名权限

创建一个entitlements.plist文件，授予Chromium必需的权限：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- 允许网络访问 -->
    <key>com.apple.security.network.client</key>
    <true/>
    <!-- 允许JIT编译（Chromium核心需求） -->
    <key>com.apple.security.cs.allow-jit</key>
    <true/>
    <!-- 允许未签名的可执行内存 -->
    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
    <true/>
    <!-- 禁用库验证，避免Chromium的第三方库被拦截 -->
    <key>com.apple.security.cs.disable-library-validation</key>
    <true/>
</dict>
</plist>

然后用以下命令签名（替换成你的开发者证书ID）：

codesign --force --deep --sign "你的开发者证书ID" --entitlements entitlements.plist ./dist/tester.app

--deep参数一定要加，确保嵌套的Chromium框架和二进制文件都被正确签名。

3. Windows平台：确保签名覆盖所有依赖

Windows下用signtool签名时，要确保覆盖所有相关的dll（尤其是QWebEngine的Chromium组件）：

signtool sign /f "你的代码签名证书.pfx" /p "证书密码" /t http://timestamp.digicert.com ./dist/tester.exe

如果还是有问题，检查dist目录下是否存在PySide6/QtWebEngineProcess.exe及相关资源文件夹，确保这些文件都被正确签名。

4. 调试排查：查看运行日志

如果签名后还是异常，打开控制台查看错误日志：

• macOS：open -a ./dist/tester.app --args --enable-logging
• Windows：直接在命令行运行tester.exe
  日志里通常会明确提示是权限不足还是资源缺失，根据提示针对性修复。

额外注意事项 #

• 不要在PyInstaller打包时直接指定签名，建议先打包出正常运行的应用，再单独签名，避免两者流程相互干扰。
• 确保你的签名证书是有效的（macOS需开发者证书，Windows需正规代码签名证书）。

备注：内容来源于stack exchange，提问作者nicolaum