PyInstaller打包exe仅首次运行报错 错误无法复现问题咨询

请问为何PyInstaller打包的应用程序无法稳定复现报错信息？是否存在exe运行期间或两次运行间隙留存的、未被留意到的临时数据/内存存储？

• 首次运行打包生成的exe时会弹出错误提示，随后程序快速关闭
• 第二次运行时无错误弹窗，程序运行一段时间后才关闭
• 目前已尝试常规排查操作，仅能通过重新编译应用程序的方式让报错再次出现

使用的.spec文件配置如下：

# -*- mode: python ; coding: utf-8 -*-
import sys
import os
site_packages_dir = next(p for p in sys.path if 'site-packages' in p)
block_cipher = None


a = Analysis(['src\\dag\\app.py'],
             pathex=['.\\src\\'], # 适配相对导入
             binaries=[],
             datas=[],
             hiddenimports=[],
             hookspath=[],
             hooksconfig={},
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
             
# 打包assets资源文件夹
a.datas += Tree('.\\assets', prefix='assets\\')

site_packages_list = ['distributed']
for package in site_packages_list:
    a.datas += Tree(os.path.join(site_packages_dir, package), prefix=(package + '\\'))

pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)

exe = EXE(pyz,
          a.scripts,
          a.binaries,
          [],
          exclude_binaries=True,
          name='app',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          console=True,
          disable_windowed_traceback=False,
          target_arch=None,
          codesign_identity=None,
          entitlements_file=None )
coll = COLLECT(exe,
               a.binaries,
               a.zipfiles,
               a.datas, 
               strip=False,
               upx=True,
               upx_exclude=[],
               name='app')

这个现象和PyInstaller的临时文件解压、缓存机制直接相关，不存在跨运行的内存留存——程序退出后操作系统会自动回收所有进程分配的内存，问题出在持久化写到磁盘的临时文件：

1. PyInstaller运行时的临时文件逻辑
   你当前用的是COLLECT生成的单目录打包模式，exe启动时首先会跑bootloader逻辑：首次启动时会把部分依赖、需要解压的运行时资源释放到系统临时目录（Windows下默认路径是%TEMP%\_MEIxxxxxx，xxxxxx是随机生成的数字后缀）。如果首次启动时解压流程中断、文件权限不足、被安全软件拦截删掉了部分文件，就会立刻弹错闪退。
   如果首次崩溃时已经有部分文件写入了临时目录，第二次启动时bootloader检测到对应路径的残留文件存在，会直接跳过解压步骤加载残留内容，不会触发首次解压阶段的报错，直到程序运行到需要调用缺失/损坏的依赖时才会崩溃，就会出现你看到的「二次运行无弹窗、跑一段时间才关闭」的现象。
   只有重新编译时，新版本exe对应的_MEI文件夹版本标识变了，才会触发全新的解压流程，让首次启动的报错再次出现。

2. 你当前spec配置里的明确触发点

• 你手动通过Tree把distributed整个包从site-packages拷贝进打包资源，这个包运行时会生成动态配置、锁文件、节点通信缓存，首次启动如果崩溃没走完初始化，残留的锁文件会直接让第二次启动跳过初始化校验，触发异常行为。
• 你开了upx=True压缩，Windows下部分被UPX压缩过的二进制依赖，首次解压时会被Defender等安全软件误判为恶意文件隔离，触发首次启动报错；第二次运行时被隔离的文件不会再触发实时扫描的告警规则，就不会立刻弹错，直到调用对应缺失文件时才崩溃。

3. 验证和修复步骤

• 先验证临时文件影响：每次运行完exe后，手动删掉%TEMP%下所有前缀为_MEI的文件夹，再启动exe，如果每次都能复现首次启动的报错，就能确认是临时文件残留导致的复现不稳定。
• 关掉spec里的UPX压缩：把exe和coll配置段里的upx=True都改成upx=False，排除二进制被压缩损坏、被安全软件拦截的问题。
• 不要手动用Tree拷贝整个distributed包：PyInstaller自带针对distributed的官方依赖hook，直接把distributed加到hiddenimports列表里，让hook自动处理依赖和资源文件，避免手动拷贝漏了依赖元数据、或者把不必要的缓存文件打包进去。
• 抓完整报错日志：把exe配置段的debug=False改成debug=True，从cmd命令行启动exe，不要直接双击运行，这样闪退时的完整错误栈会留在控制台里，不用靠反复复现弹窗看报错。

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