Pygame经Auto Py to Exe打包为exe后关窗弹出多窗口问题排查

该问题是PyInstaller（Auto Py to Exe底层打包引擎）运行机制差异 + Firebase依赖的后台子进程未主动清理共同导致，与你编写的Pygame退出逻辑本身无直接关联，根因可对应你的观察逐一验证：

• 触发逻辑：PyInstaller打包的exe在Windows环境下，对通过multiprocessing.spawn方式启动的子进程无自动上下文绑定；而Firebase Admin SDK依赖的Google API核心库、异步认证模块，会在初始化时自动拉起多个后台异步线程和派生子进程，这些进程默认将当前可执行文件路径（即打包后的exe）作为自身的运行入口。
• 脚本直跑无故障的原因：原生Python环境下，spawn模式的子进程会绑定当前Python解释器的运行上下文，主进程退出时，派生子进程会随主解释器的销毁自动终止，不会触发脚本重跑；但打包为exe后，主进程触发退出流程、抛出SystemExit时，未被主动关闭的Firebase关联子进程，会独立调用exe入口路径重新执行完整脚本逻辑，直接表现为反复弹出新Pygame窗口、重复打印Pygame启动日志。
• 异常捕获仅见SystemExit的原因：你代码中捕获的SystemExit是主进程退出流程抛出的异常，所有被派生进程拉起的新脚本执行流，根本没有运行到你写的异常捕获代码块，就已经卡在Pygame初始化阶段，因此日志中只会反复出现Pygame启动提示，不会打印后续的退出捕获信息。

• 必加打包兼容代码：在整个脚本的最开头位置（所有第三方库import语句之前），添加multiprocessing.freeze_support()，该函数是PyInstaller打包场景下专门用于阻止派生子进程重跑主脚本入口的兼容逻辑，添加后重新打包即可验证：

  # 脚本第一优先级执行
  import multiprocessing
  multiprocessing.freeze_support()
  

• 主动清理Firebase关联资源：在执行Pygame退出逻辑之前，主动销毁所有初始化的Firebase应用实例、终止关联的后台异步线程，不要等待解释器自动触发垃圾回收，示例代码：

  # 放在pygame.quit()语句之前执行
  try:
      for app in firebase_admin._apps.values():
          firebase_admin.delete_app(app)
  except:
      pass
  

• 调整Auto Py to Exe打包配置：在隐藏导入配置中手动补充multiprocessing、firebase_admin、googleapiclient的全量子模块，避免因依赖缺失导致的子进程重拉问题；同时关闭打包Debug模式，避免Debug模式下保留的子进程重执行逻辑。
• 优化退出流程顺序：将原有退出逻辑的执行顺序调整为「清理第三方后台资源 → 停止Pygame运行时 → 触发程序退出」，不要先终止Pygame运行时，再等待其他第三方模块自动清理资源。

补充说明：你观察到的“Firebase模块全流程运行正常”完全符合该问题特征——Firebase的后台线程在主程序运行阶段仅用于接口通信，不会干扰Pygame窗口逻辑，只有在程序退出阶段，因打包环境的路径差异，才会触发未清理进程的重跑bug，日常运行时无任何可感知异常。

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