PyInstaller打包单文件exe在不同Win10设备首次启动异常求助

问题背景 #

使用Python 3.11.3结合PyQt5及其他模块开发程序，通过PyInstaller 5.10.1打包为Windows 10单文件可执行文件。本地测试时脚本与exe均运行正常，但复制到3台其他Windows 10 64位PC后，出现仅首次启动触发、重启后异常消失的问题：

• PC1：exe直接崩溃，无错误提示
• PC2：执行表格操作后部分单元格突然变为空
• PC3：崩溃报错ValueError: invalid literal for int() with base 10: '3-5'（该输入场景已在脚本中做过滤处理）

已排查情况 #

• 排除系统架构差异（所有测试设备均为Windows 10 64位）
• 排除hiddenimports问题（二次启动exe可正常运行）
• 通过.spec文件添加排除项缩减exe体积（从50MB降至40MB），本地测试无影响：

  excludes=['pandas', 'numpy', 'matplotlib', 'scipy', 'PIL', 'sqlite3', 'setuptools', 'opencv', 'ocr', 'paramiko'],
  

依赖模块清单 #

from PyQt5.QtWidgets import QAbstractItemView, QAction, QApplication, QHBoxLayout, QLabel, QLineEdit, QMainWindow,  QMessageBox, QPushButton, QTableWidget, QTableWidgetItem, QVBoxLayout, QWidget
from PyQt5.QtCore import pyqtSlot, Qt
from PyQt5.QtGui import QIcon
import sys, re, os
from pypdf import PdfReader, PdfWriter, Transformation
from math import cos, sin, atan, sqrt, radians, pi

排查方向建议 #

1. 验证VC++ Redistributable版本
   Python 3.11依赖Visual Studio 2019版本的VC++ Redistributable（x64）。目标PC若未安装或版本过低，首次解压单文件exe时可能因依赖缺失触发崩溃或异常。建议在目标PC安装对应版本的VC++ Redistributable后重试。

2. 排查单文件解压的资源竞争问题
   PyInstaller单文件exe启动时会临时解压到%TEMP%/_MEIxxxxxx目录，首次解压可能因以下原因导致异常：

• 目标PC临时目录权限不足，exe无法完成读写操作
• 杀毒软件将临时解压的文件误判为恶意程序拦截
• 压缩/解压过程中出现文件损坏

可尝试：

• 检查目标PC临时目录的读写权限
• 临时关闭杀毒软件后测试
• 打包时添加--no-compress参数，避免解压时的压缩异常

3. 检查首次启动的初始化逻辑
   异常仅首次出现，大概率与首次启动的初始化流程相关：

• 确认是否存在依赖本地配置文件/缓存的逻辑，首次启动时配置文件未生成，导致异常；重启时配置已存在，恢复正常
• 针对PC3的报错，需排查首次启动时是否存在未初始化的变量或缓存数据污染，导致输入校验逻辑失效
• 添加全局异常捕获，将错误日志写入本地文件，方便首次崩溃时排查具体原因：

  import sys
  import traceback
  
  def excepthook(exc_type, exc_value, exc_traceback):
      with open("error.log", "w") as f:
          traceback.print_exception(exc_type, exc_value, exc_traceback, file=f)
      sys.__excepthook__(exc_type, exc_value, exc_traceback)
  
  sys.excepthook = excepthook
  

4. 优化PyInstaller打包参数

• 尝试移除excludes中的部分项，排查是否因过度排除导致隐性依赖缺失
• 打包时添加--debug=all参数生成调试版exe，在目标PC运行查看详细启动日志
• 改用--onedir模式打包测试，确认是单文件模式特有问题还是通用打包问题

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