PyInstaller打包成功后运行exe无界面无输出问题求助

问题背景 #

我用Python编写了一个应用，尝试打包为可执行文件，依赖模块如下：

import asyncio
import os
import time
from dotenv import load_dotenv
from winsdk.windows.media.control import (
    GlobalSystemMediaTransportControlsSessionManager as MediaManager,
)
import musicbrainzngs
from difflib import SequenceMatcher
import PySimpleGUI as sg
from psgtray import SystemTray
import selenium
from selenium import webdriver
import requests

执行的打包命令：

python -m PyInstaller --onefile --paths=./venv/Lib/site-packages app.pyw 

打包过程无警告或错误，但点击exe或通过命令行运行时，任务管理器能看到进程，却没有预期的UI窗口或控制台输出。查看warn-app.txt发现大量缺失模块，不确定这些模块是否是问题根源，也不清楚为何会出现这么多缺失项。

warn-app.txt核心说明与部分内容 #

该文件列出PyInstaller无法找到的模块，但这些模块不一定是程序运行必需项。Python及其第三方包包含大量条件或可选模块，例如ntpath仅存在于Windows，posixpath仅存在于类Unix系统。

导入类型分类：

• top-level: 顶层导入 - 优先排查此类
• conditional: if语句内的条件导入
• delayed: 函数内部的延迟导入
• optional: try-except语句内的可选导入

重要提示：不要将此列表提交到问题追踪器，以此为基础自行排查缺失模块。

部分缺失模块示例：

missing module named pyimod02_importers - imported by ...
missing module named jnius - imported by pkg_resources._vendor.platformdirs.android (delayed, optional)
missing module named _winreg - imported by platform (delayed, optional), selenium.webdriver.firefox.firefox_binary (delayed, optional)
missing module named asyncio.DefaultEventLoopPolicy - imported by asyncio (delayed, conditional), asyncio.events (delayed, conditional)

解决思路与方案 #

1. 过滤无效缺失模块 #

大部分缺失模块是跨平台条件导入或可选依赖（比如类Unix系统的pwd、grp，非Windows环境的posix相关模块），这些不会影响Windows下的程序运行。重点关注和你的直接业务依赖相关的模块：

• winsdk相关：PyInstaller可能未自动捕获winsdk.windows.media.control的深层依赖
• psgtray/pystray：需确保Windows平台所需的pystray._win32模块被正确打包
• selenium：需保证浏览器驱动（如chromedriver.exe）能被程序找到

2. 调整打包命令参数 #

• 移除--paths=./venv/Lib/site-packages：虚拟环境下PyInstaller会自动识别依赖路径，手动指定可能导致冲突
• 调试阶段改用.py后缀打包，去掉默认无控制台设置，方便查看报错：

  python -m PyInstaller --onefile app.py
  

• 手动添加关键隐藏依赖：

  python -m PyInstaller --onefile --hidden-import=winsdk.windows.media.control --hidden-import=pystray._win32 --hidden-import=psgtray app.py
  

3. 捕获运行时错误信息 #

• 将.pyw改为.py后重新打包，运行exe时会弹出控制台，直接显示程序崩溃的具体原因（比如某个核心模块缺失）
• 或在命令行直接执行exe：app.exe，控制台会输出详细报错

4. 处理资源文件依赖 #

• 如果用到.env文件，需通过--add-data参数将其打包进程序：

  python -m PyInstaller --onefile --add-data ".env;." app.py
  

• selenium的浏览器驱动需放在exe同目录，或在代码中指定驱动路径为PyInstaller临时目录：

  import sys
  from selenium import webdriver
  
  driver_path = os.path.join(sys._MEIPASS, "chromedriver.exe")
  driver = webdriver.Chrome(executable_path=driver_path)
  

5. 修复asyncio相关问题 #

针对warn中提到的asyncio.DefaultEventLoopPolicy缺失，可在代码开头显式设置Windows事件循环：

import asyncio
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

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