PyInstaller打包PyQt5 GUI程序时出现segmentation fault:11崩溃问题

崩溃根因 #

从提供的崩溃堆栈可以定位到：程序在初始化QApplication的阶段直接崩溃，核心诱因是空指针访问——Qt在加载平台插件、查询自身库文件路径时，调用macOS系统接口CFBundleCopyBundleURL获取当前程序的Bundle信息，但PyInstaller默认生成的无标准Mac应用结构的裸可执行文件，传入该接口的Bundle句柄为空，直接触发段错误。

可落地解决方法 #

• 优先采用标准macOS应用结构打包
  打包时不要加--onefile参数，改用--windowed生成符合macOS规范的.app目录结构，命令示例：

  pyinstaller --windowed --name "MyApp" main.py
  

  该模式下生成的目录完全匹配macOS应用的结构要求，CFBundleCopyBundleURL可获取合法的Bundle句柄，从根源上避免空指针崩溃。
• 如需单文件/控制台模式运行，提前手动指定Qt路径
  如果必须生成单文件可执行、或需要保留控制台输出窗口，需要在代码中所有导入PyQt5模块的语句之前，手动指定Qt的平台插件路径，绕过Qt自动通过系统接口查询路径的逻辑：

  import sys
  import os
  # 识别PyInstaller打包后的运行环境
  if getattr(sys, 'frozen', False):
      bundle_dir = sys._MEIPASS
      # 手动指定Qt平台插件位置，避免自动查询时空指针崩溃
      os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = os.path.join(
          bundle_dir,
          'PyQt5',
          'Qt5',
          'plugins',
          'platforms'
      )
  # 之后再正常导入PyQt5相关模块
  from PyQt5.QtWidgets import QApplication, QWidget
  

• 排除冗余库冲突
  从堆栈中可见残留的libopenblas.0.dylib加载线程，如果项目依赖numpy、scipy等会引入OpenBLAS的库，需要避免不同版本的库被混合打包：
  • 先升级所有相关依赖到最新兼容版本：

    pip install --upgrade pyinstaller PyQt5 PyQt5-Qt5 PyQt5-sip
    

  • 打包时通过--exclude-module排除冗余的同名库，避免加载顺序错乱触发崩溃。

调试技巧：打包完成后在终端中启动生成的可执行文件，不要直接双击运行——如果路径配置错误，终端会打印明确的Qt插件找不到的提示，根据提示的实际路径调整环境变量的值即可，不需要反复盲改配置。

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