如何在Kivy应用中实现多线程以避免UI冻结

问题根源 #

Kivy的UI渲染和用户交互都运行在主线程，你代码里的gather_srs()耗时5分钟，会完全阻塞主线程，导致应用失去响应、无法操作。

最优解决思路 #

用子线程处理耗时任务，同时通过Kivy的Clock工具在主线程安全更新UI状态（比如添加加载提示、禁用按钮），既不阻塞UI，又能给用户反馈。

具体实现（附修改后代码） #

以下是调整后的完整代码，解决了冻结问题，还优化了用户体验：

from kivy.app import App
from kivy.uix.gridlayout import GridLayout
from kivy.uix.button import Button
from kivy.uix.label import Label
from kivy.uix.textinput import TextInput
from kivy.clock import Clock
import threading

# 移除不必要的_cffi_backend导入
from ExtractTestName import ExtractTestName
from ExtractTestProtocols import ExtractTestProtocols
from SRSGathering import SRSGathering
from WriteToExcel import WriteToExcel


# 重命名自定义布局类，避免和Kivy内置的GridLayout重名（新手易踩坑）
class MainGridLayout(GridLayout):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.rows = 3  # 新增一行放置加载提示
        self.cols = 2
        
        self.text1 = TextInput(text='Enter SRS Path', multiline=False)
        self.add_widget(self.text1)

        self.text2 = TextInput(text='Enter TP Path', multiline=False)
        self.add_widget(self.text2)

        self.btn1 = Button(text='Calculate RTM')
        self.btn1.bind(on_press=self.start_calculation)
        self.add_widget(self.btn1)

        self.btn2 = Button(text='Clear text')
        self.btn2.bind(on_press=self.callback2)
        self.add_widget(self.btn2)

        # 加载提示标签，初始隐藏
        self.loading_label = Label(text='正在计算，请稍候...', opacity=0)
        self.add_widget(self.loading_label)
        self.add_widget(Label())  # 占位对齐布局

    def start_calculation(self, elem):
        # 禁用计算按钮，防止重复触发
        self.btn1.disabled = True
        # 显示加载提示
        self.loading_label.opacity = 1
        # 启动子线程执行耗时任务，daemon=True确保线程随主程序退出
        threading.Thread(target=self.perform_calculation, daemon=True).start()

    def perform_calculation(self):
        # 所有耗时逻辑放在子线程
        try:
            srs_object = SRSGathering(self.text1.text)
            srs = srs_object.gather_srs()
            excel_obj = WriteToExcel('SRS.xlsx', srs)
            excel_obj.writetoexcel_DF()
            # 任务完成后，通过Clock通知主线程更新UI（Kivy禁止子线程操作UI）
            Clock.schedule_once(self.on_calculation_done, 0)
        except Exception as e:
            # 捕获异常，通知主线程显示错误信息
            Clock.schedule_once(lambda dt: self.on_calculation_error(str(e)), 0)

    def on_calculation_done(self, dt):
        # 恢复UI状态
        self.btn1.disabled = False
        self.loading_label.text = '计算完成！'
        # 2秒后恢复提示文本并隐藏
        Clock.schedule_once(lambda dt: self.reset_loading_label(), 2)

    def on_calculation_error(self, error_msg):
        # 错误处理：恢复按钮，显示错误提示5秒
        self.btn1.disabled = False
        self.loading_label.text = f'计算出错：{error_msg}'
        Clock.schedule_once(lambda dt: self.reset_loading_label(), 5)

    def reset_loading_label(self):
        self.loading_label.opacity = 0
        self.loading_label.text = '正在计算，请稍候...'

    def callback2(self, elem):
        self.text1.text = ""
        self.text2.text = ""

class DemoApp(App):
    def build(self):
        return MainGridLayout()

if __name__ == '__main__':
    DemoApp().run()

关键注意事项 #

1. 线程隔离：耗时操作必须放在子线程，绝对不能在UI回调（比如按钮点击）里直接执行，否则必然阻塞主线程
2. UI更新安全：Kivy不允许在子线程中修改UI元素（比如按钮状态、标签文本），必须通过Clock.schedule_once将UI操作切换到主线程执行
3. 用户体验优化：禁用操作按钮防止重复触发，添加加载提示让用户明确知道应用在后台工作
4. 避免命名冲突：自定义布局类不要和Kivy内置组件重名（比如原代码的GridLayout），否则会引发未知问题
5. 异常处理：子线程中的异常不会自动反馈到主线程，必须手动捕获并通过Clock通知UI层显示错误

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