PyInstaller打包PyQt5生成的.exe文件无法运行求助

一、让CMD保持打开查看报错信息 #

不要用start app.exe启动程序，直接在CMD中切换到dist文件夹路径，直接运行urimare.exe，程序崩溃后CMD窗口会保留，能直接看到具体错误输出。

二、排查可能的问题点 #

1. 资源文件路径问题 #

打包后程序的运行路径与开发环境不同，需确保代码中资源读取路径正确：

• 对于.qrc资源文件，建议先转换为Python文件：执行pyrcc5 resources.qrc -o resources_rc.py，然后在main.py中导入import resources_rc，避免直接打包qrc文件导致的路径识别问题。
• 数据库文件database.db，代码中读取时用动态路径：

  import os
  db_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "model", "database.db")
  

  替代硬编码的model\database.db。

2. Pandas隐藏依赖缺失 #

PyInstaller常无法自动识别Pandas的全部依赖，需在.spec文件的hiddenimports中补充：

hiddenimports=['pandas._libs.tslibs.timedeltas', 'pandas._libs.tslibs.np_datetime', 'pandas._libs.tslibs.nattype', 'pandas._libs.skiplist'],

可先通过CMD运行exe得到具体的ImportError，再针对性添加缺失模块。

3. 图标路径与格式问题 #

• 确保.spec中图标路径r".\resources\iconosApp\urimareIcono01.ico"相对于执行pyinstaller命令的目录是正确的，也可尝试使用绝对路径。
• 检查ICO文件是否为有效格式（建议256x256尺寸，避免格式不兼容导致加载失败）。

4. 模型代码的潜在错误 #

你的CustomTableModel存在两处可能导致崩溃的问题：

• data方法中先取值再判断索引有效性，需调整顺序：

  def data(self, index, role):
      if not index.isValid():
          return None
      value = self._data_source.iloc[index.row(), index.column()]
      # 后续逻辑...
  

• headerData方法无默认返回值，不符合Qt模型要求：

  def headerData(self, section, orientation, role=QtCore.Qt.DisplayRole): 
      if orientation == QtCore.Qt.Horizontal and role == QtCore.Qt.DisplayRole:
          if section < len(self._data_source.columns):
              return self._data_source.columns[section]
      return None  # 添加默认返回值
  

三、重新打包步骤 #

1. 修复代码中的路径问题与模型代码错误。
2. 转换qrc文件为py文件并在main.py中导入。
3. 更新.spec文件的hiddenimports配置。
4. 执行pyinstaller main.spec重新打包，运行exe查看报错并逐步解决。

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