Python Tkinter应用启动时添加数据库连接进度条的问题

核心思路 #

把数据库连接操作放到子线程中执行，避免阻塞Tkinter主线程，同时在主线程显示带有动态进度提示的加载窗口，让用户明确程序正在尝试连接，不会误以为卡死。

完整实现代码 #

import tkinter as tk
from tkinter import ttk
import threading
import MySQLdb
import ctypes

# Windows消息框常量定义
MB_OK = 0x00000000
ICON_STOP = 0x00000010

class App:
    def __init__(self):
        self.root = tk.Tk()
        self.root.withdraw()  # 先隐藏主窗口
        self.loading_win = None
        self.db_conn = None
        self.error_info = ""

        # 启动加载窗口和数据库连接线程
        self.init_loading_window()
        self.db_thread = threading.Thread(target=self.attempt_db_connect)
        self.db_thread.daemon = True
        self.db_thread.start()

        # 主线程轮询连接状态
        self.root.after(100, self.check_connect_status)
        self.root.mainloop()

    def init_loading_window(self):
        # 创建加载窗口
        self.loading_win = tk.Toplevel()
        self.loading_win.title("启动中")
        self.loading_win.geometry("300x100")
        self.loading_win.resizable(False, False)

        # 窗口居中
        self.loading_win.update_idletasks()
        screen_w = self.loading_win.winfo_screenwidth()
        screen_h = self.loading_win.winfo_screenheight()
        win_x = (screen_w // 2) - 150
        win_y = (screen_h // 2) - 50
        self.loading_win.geometry(f"+{win_x}+{win_y}")

        # 添加提示文本和进度条
        ttk.Label(self.loading_win, text="正在连接数据库...").pack(pady=10)
        self.progress = ttk.Progressbar(self.loading_win, mode='indeterminate')
        self.progress.pack(fill=tk.X, padx=20, pady=5)
        self.progress.start(10)

    def attempt_db_connect(self):
        # 子线程执行数据库连接
        try:
            self.db_conn = MySQLdb.connect(
                host="hostname",
                port=port,
                user="username",
                password="password",
                database="database_name",
                connect_timeout=10  # 设置连接超时，避免无限等待
            )
        except MySQLdb.Error as e:
            self.db_conn = None
            self.error_info = str(e)

    def check_connect_status(self):
        # 主线程检查连接是否完成
        if self.db_thread.is_alive():
            self.root.after(100, self.check_connect_status)
            return

        # 结束加载动画并关闭窗口
        self.progress.stop()
        self.loading_win.destroy()

        if self.db_conn:
            # 连接成功，显示主窗口
            self.root.deiconify()
            # 此处添加主窗口的业务逻辑
            ttk.Label(self.root, text="数据库连接成功！").pack(pady=20)
        else:
            # 连接失败，提示并退出
            ctypes.windll.user32.MessageBoxW(
                0,
                f"数据库连接失败，请稍后重试。错误信息：{self.error_info}",
                "错误",
                MB_OK | ICON_STOP
            )
            self.root.quit()

if __name__ == "__main__":
    App()

关键改进说明 #

• 线程分离：数据库连接在子线程运行，不阻塞Tkinter主线程，确保加载窗口能正常显示动态效果。
• 超时控制：给MySQLdb.connect添加connect_timeout参数，限制最长等待时间，避免离线时无限挂起。
• 用户反馈：使用indeterminate模式进度条，模拟加载动画，让用户直观感知程序状态。
• 窗口优化：加载窗口居中显示，提升视觉体验。

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