为何Kivy的UrlRequest回调会阻塞GUI线程？

我开发了一款Kivy应用，界面包含一个下载按钮，用于下载并处理远程数据表。功能运行正常，但过程中GUI会被阻塞，表现为MDSpinner在中途冻结，直至下载完全结束。

整个下载（DL）流程已在不涉及GUI操作的独立线程中运行，本不应出现阻塞问题。

经排查发现，阻塞源于UrlRequest的回调函数——即使在回调中加入简单的sleep操作，也会导致GUI卡顿！

请问这是什么原因？是否需要为回调函数再单独开启线程？

以下为简化伪代码以复现问题：

from kivy.network.urlrequest import UrlRequest
from functools import partial
from kivy.clock import Clock, mainthread
from threading import Thread
from kivymd.uix.screen import MDScreen 
import time

class myScreen(MDScreen):

    def on_button(self):
        # activate spinner when download button pressed
        self.ids.spinner.active = True
    
        # run sync stuff in new thread
        t = Thread(target=self.sync_thread)
        t.start()


    def sync_thread(self):
        # lots of code here including several async downloads like this:
        download(some_url)
        
        # when all downloads are done, kill spinner
        self.kill_spinner()
        
        
    @mainthread
    def kill_spinner(self):
        # uses decorator to set gui widget from another thread
        self.ids.spinner.active = False


# URLRequest code -----------------------------
def download(self, url):
    cb = partial(mycallback, arg)
    UrlRequest(url=url, req_headers=myconfig.headers, timeout=timeout, on_success=cb, on_error=cb, on_failure=cb)


def mycallback(self, arg):
    # used to process data from each download
    # PROBLEM LIES HERE!  Anything here - even a simple sleep will hang spinner(gui) until finished
    time.sleep(5)

原因 #

Kivy的UrlRequest是基于主事件循环实现的异步操作，它的回调函数默认会在主线程（GUI线程）中执行。哪怕你在独立线程里调用UrlRequest，它的回调依然会被调度到主线程运行。所以当你在mycallback里执行time.sleep(5)这类阻塞操作时，主线程被占用，GUI自然会冻结。

解决方案 #

是的，必须把回调里的耗时操作放到单独线程中执行，避免阻塞主线程：

1. 将耗时逻辑剥离到子线程
   修改mycallback，只在回调里启动子线程处理任务，主线程仅负责必要的GUI交互：

def mycallback(self, arg):
    # 启动子线程处理耗时任务
    t = Thread(target=self.process_data, args=(arg,))
    t.start()

def process_data(self, arg):
    # 这里放原来的耗时操作，比如数据解析、sleep等
    time.sleep(5)
    # 如果需要更新GUI，用@mainthread装饰器或Clock.schedule_once确保在主线程执行
    self.finish_process()

@mainthread
def finish_process(self):
    # 示例：处理完成后的GUI更新操作
    pass

2. 严格区分主线程与子线程任务
   任何需要长时间运行的逻辑（如数据处理、文件IO）都不能直接放在UrlRequest的回调里，必须放到子线程中执行。

3. 保证线程安全
   如果多个子线程需要共享数据，记得使用threading.Lock加锁，避免数据竞争问题。

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