如何解决Django项目中Tkinter进度条窗口无响应的问题

问题原因 #

• Tkinter是单线程事件驱动模型，所有UI渲染、交互响应都依赖内部的事件循环，你将耗时的下载逻辑和UI更新放在同一线程执行时，下载逻辑会阻塞事件循环，直接导致窗口无响应。
• 代码本身存在两处逻辑错误：
  • 循环内progress['value']每次都被赋值为固定的单步值，没有累加，进度条不会正常推进
  • progress.pack()放在循环结束后才执行，循环运行过程中进度条根本没被渲染到窗口上
• Django服务本身运行在主线程中，和Tkinter的事件循环存在抢占冲突，不适合直接在Django的请求/业务逻辑中启动桌面UI组件。

修复方案 #

如果你是本地自用的离线Django工具场景，可以按以下方案修改：

1. 拆分耗时任务和UI逻辑：将下载逻辑放到子线程执行，UI更新通过Tkinter的after()方法调度到主线程执行，禁止子线程直接操作Tkinter控件。
2. 提前渲染UI组件，进度值累加更新。

参考修改代码 #

import threading
from tkinter import Tk, HORIZONTAL
from tkinter.ttk import Progressbar
import datetime
import sys

class myFunction():
    def __init__(self, user, password, url, port, db_password, username):
        self.zaman = datetime.now().strftime("%Y-%m-%d")
        # 存储进度值，子线程写、主线程读
        self.progress_value = 0
        self.scans = [] # 提前获取scans数据，不要放到Tkinter线程中处理
        self.download_all(user, password, url, port, db_password)

    def update_progress(self, root, progress):
        progress['value'] = self.progress_value
        # 进度未完成时每100ms更新一次
        if self.progress_value < 100:
            root.after(100, self.update_progress, root, progress)
        else:
            # 下载完成后可自动关闭窗口
            root.destroy()

    def download_task(self, user, password, url, port, db_password):
        # 子线程仅运行耗时下载逻辑，不操作任何UI控件
        try:
            sys.path.append('../')
            # 你的其他前置逻辑
            bar = Bar('Processing', max=len(self.scans))
            pb_length = len(self.scans)
            pb_step = 100 / pb_length
            for s in self.scans:
                # 仅更新进度数值
                self.progress_value += pb_step
                bar.next()
                scanner.scan_name = s['name']
                scanner.scan_id = s['id']
                # 你的下载存储逻辑
            bar.finish()
            self.progress_value = 100
        except (KeyError, ConnectionError):
            pass

    def download_all(self, user, password, url, port, db_password):
        # 主线程初始化Tkinter组件
        root = Tk()
        progress = Progressbar(root, orient=HORIZONTAL, length=100, mode='determinate')
        root.title("Sending")
        root.attributes("-topmost", True)
        w = root.winfo_reqwidth()
        h = root.winfo_reqheight()
        ws = root.winfo_screenwidth()
        hs = root.winfo_screenheight()
        x = (ws / 2) - (w / 2)
        y = (hs / 2) - (h / 2)
        root.geometry('+%d+%d' % (x, y))
        # 提前渲染进度条
        progress.pack(pady=10)
        # 启动下载子线程
        threading.Thread(target=self.download_task, args=(user, password, url, port, db_password), daemon=True).start()
        # 启动进度更新调度
        self.update_progress(root, progress)
        # 启动Tkinter事件循环
        root.mainloop()

注意事项 #

• 该方案仅适合本地运行的桌面化Django工具，如果是线上部署的web服务，完全不适合用Tkinter做进度展示，改为前端轮询接口获取进度、用前端组件渲染进度条即可，配套Celery做异步任务调度就是标准实现方案。
• 子线程设置daemon=True，避免主线程退出后子线程残留。

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