如何修复PyInstaller构建PySide6 macOS应用时的版本不兼容启动错误？

这个错误是因为打包时混入了系统中旧版本的Qt5 DBus库，和PySide6依赖的Qt6库版本不兼容，按以下步骤解决：

1. 清理环境，隔离Qt5依赖 #

• 检查系统是否安装了全局Qt5（比如通过Homebrew），执行brew list | grep qt5，如果存在且不需要，执行brew uninstall qt5移除。
• 全程使用干净的虚拟环境构建，避免全局库干扰：

python -m venv pyside6_build_env
source pyside6_build_env/bin/activate
pip install PySide6==6.5.1.1 pyinstaller

2. 修改PyInstaller构建命令，强制指定Qt6库路径 #

构建时直接指定PySide6自带的Qt库路径，确保打包工具只选用Qt6版本的依赖：

pyinstaller --windowed --onefile --paths "$(python -c 'import PySide6; print(PySide6.__path__[0]+"/Qt/lib")')" your_app.py

这条命令会自动获取虚拟环境中PySide6的Qt库路径，无需手动填写。

3. 用.spec文件自定义打包（更稳定） #

如果命令行参数仍有问题，生成并编辑.spec文件精准控制依赖：

1. 生成初始.spec文件：

pyinstaller --windowed your_app.py

2. 打开生成的your_app.spec文件，修改Analysis部分：
   • 在excludes列表中添加['Qt5DBus']，排除Qt5版本的库；
   • 在binaries中手动添加PySide6的QtDBus库：

a = Analysis(
    ['your_app.py'],
    excludes=['Qt5DBus'],
    binaries=[
        (
            f"{os.path.dirname(PySide6.__file__)}/Qt/lib/QtDBus.framework/QtDBus",
            "PySide6/Qt/lib/QtDBus.framework"
        )
    ],
    # 保留其他原有配置...
)

3. 重新用.spec文件打包：

pyinstaller your_app.spec

4. 验证打包结果 #

• 右键打包好的.app文件，选择「显示包内容」，进入Contents/MacOS；
• 执行otool -L QtGui查看依赖，确认@rpath/QtDBus指向的是包内的Qt6版本库，而非系统路径的Qt5。

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