使用PyInstaller打包Kivy应用，仅窗口模式下崩溃求助

我遇到过完全相同的问题——带控制台运行正常，禁用控制台就崩溃，即使关闭了Kivy日志也没用。这通常是因为窗口模式下标准输出(stdout)/标准错误(stderr)流被系统关闭，但仍有代码（包括Kivy底层、依赖库甚至系统调用）尝试写入这些流，导致程序抛出异常崩溃。下面是几个逐层排查的解决方案：

1. 最关键：在导入Kivy前重定向标准输出/错误到空设备 #

这是解决这类问题最有效的方法，直接从根源阻止所有输出尝试写入无效流。在你的Python脚本最开头（甚至在导入任何Kivy模块之前）添加以下代码：

import sys
import os

# 重定向stdout和stderr到空设备，避免窗口模式下写入无效流
if sys.platform == 'win32':
    # Windows系统指向nul
    null_device = 'nul'
else:
    # Linux/macOS指向/dev/null
    null_device = '/dev/null'

# 以写入模式打开空设备，替换默认输出流
sys.stdout = open(null_device, 'w')
sys.stderr = open(null_device, 'w')

# 之后再导入Kivy相关模块
from kivy.app import App
# ... 你的其他代码

2. 确保Kivy日志配置正确生效 #

之前的配置可能因为执行顺序不对而没生效——必须在导入Kivy的UI模块之前设置日志配置，而且不需要调用Config.write()（那是把配置保存到本地文件，我们只需要临时生效）。调整后的配置代码：

# 先导入配置模块
from kivy.config import Config
import logging
from kivy.logger import Logger

# 禁用Kivy日志系统
Config.set('kivy', 'log_enable', '0')
# 即使没完全禁用，也只保留最严重的错误级别
Config.set('kivy', 'log_level', 'critical')
# 立即应用配置
Config.apply()

# 同时设置Python日志库的级别
Logger.setLevel(logging.CRITICAL)

# 再导入Kivy App等模块
from kivy.app import App

3. 优化PyInstaller打包参数 #

有时候崩溃是因为打包时缺失了Kivy的依赖模块，或者窗口模式的打包参数需要调整：

• 使用--noconsole（Windows下也可以用--windowed）禁用控制台
• 添加--hidden-import确保所有Kivy子模块被打包（比如一些冷门的UI组件）
• 示例打包命令：

pyinstaller --noconsole --hidden-import kivy.uix.widget --hidden-import kivy.uix.label --hidden-import kivy.graphics your_app.py

如果使用spec文件打包，确保Analysis部分的console=False，并且在hiddenimports里补充缺失的模块：

a = Analysis(
    ['your_app.py'],
    hiddenimports=['kivy.uix.widget', 'kivy.graphics'],
    # ... 其他参数
)
pyz = PYZ(a.pure)
exe = EXE(
    pyz,
    a.scripts,
    console=False,  # 关键：禁用控制台
    # ... 其他参数
)

4. 排查隐藏的异常（窗口模式看不到错误） #

如果以上方法还没解决，可以临时添加异常捕获，把错误信息写入日志文件，这样即使窗口崩溃也能找到原因：

import sys
import traceback

def custom_except_hook(exc_type, exc_value, exc_traceback):
    # 把异常信息写入本地文件
    with open('app_error_log.txt', 'w', encoding='utf-8') as f:
        traceback.print_exception(exc_type, exc_value, exc_traceback)
    # 调用系统默认的异常处理
    sys.__excepthook__(exc_type, exc_value, exc_traceback)

# 替换系统默认的异常钩子
sys.excepthook = custom_except_hook

# 之后再导入其他模块

运行窗口模式的可执行文件后，查看生成的app_error_log.txt，就能看到具体的崩溃原因（比如资源文件找不到、某个模块缺失等）。

5. 检查资源文件路径问题 #

窗口模式下，PyInstaller会把程序打包到临时目录，资源文件（比如kv文件、图片）的路径和开发环境不同，导致程序找不到资源崩溃。可以用sys._MEIPASS获取打包后的临时路径：

import sys
import os

def get_resource_path(relative_path):
    try:
        # PyInstaller打包后的临时目录路径
        base_path = sys._MEIPASS
    except Exception:
        # 开发环境下的当前目录
        base_path = os.path.abspath('.')
    return os.path.join(base_path, relative_path)

# 示例：加载kv文件
from kivy.lang import Builder
Builder.load_file(get_resource_path('ui/main.kv'))

# 示例：加载图片
from kivy.uix.image import Image
img = Image(source=get_resource_path('assets/logo.png'))

按这个顺序尝试，基本能解决90%以上的窗口模式崩溃问题。

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