Kivy GUI程序中Thread join()方法无法正常工作的问题排查

问题根源 #

Kivy的GUI运行在主线程中，所有UI操作必须在这个线程执行，且主线程不能被阻塞——一旦主线程被阻塞，UI刷新会暂停，用户看不到界面变化。你的代码存在两个核心问题：

• 保留thread.join()时：主线程被强制等待子线程完成，deactivate_widgets的UI修改还没来得及刷新到界面，子线程就结束了，紧接着activate_widgets又把UI改回去，导致看起来deactivate_widgets没生效。
• 移除thread.join()时：主线程不等待子线程，启动子线程后立刻执行activate_widgets，UI刚进入禁用状态就被恢复，不符合预期。

解决方案 #

核心思路是：不让主线程阻塞，子线程完成后主动通知主线程执行UI恢复操作，同时确保所有UI操作都在主线程执行。

修改步骤 #

1. 移除thread.join()，避免阻塞主线程。
2. 用包装函数包裹子线程任务，在market_parse执行完成（无论是否异常）后，通过Kivy的Clock.schedule_once将activate_widgets调度到主线程执行。
3. 如果market_parse中更新进度条：进度条属于UI组件，不能在子线程直接修改属性，必须通过Clock.schedule_once将更新操作放到主线程。

修改后的Python代码 #

from kivy.clock import Clock
from kivy.core.window import Window
from kivy.lang import Builder
from kivymd.app import MDApp
import threading

# 假设你的market_parse函数在这里定义
def market_parse(input_val, progress_indicator):
    # 示例：模拟解析任务并更新进度条
    import time
    for i in range(101):
        time.sleep(0.02)
        # 必须在主线程更新进度条
        Clock.schedule_once(lambda dt, val=i: setattr(progress_indicator, 'value', val))

KV = '''
FloatLayout:
    adaptive_size: True
    canvas:
        Color:
            rgba: 42/255, 46/255, 53/255, 1
        Rectangle:
            pos: self.pos
            size: self.size

    MDTextField:
        id: input_field
        mode: "outlined"
        size_hint: .85, None
        adaptive_size: True
        pos_hint: {"center_x": .5, "center_y": .5}
        MDTextFieldHintText:
            text: "Name"

    MDButton:
        id: search_button
        style: "filled"
        pos_hint: {"center_x": .5, "center_y": .35}
        radius: 10
        adaptive_size: True
        disabled: False
        on_press:
            app.button_press()
        MDButtonIcon:
            icon: "magnify"
        MDButtonText:
            text: "Price"
            bold: True

    MDCircularProgressIndicator:
        id: load_indicator
        size_hint: None, None
        size: "24dp", "24dp"
        pos_hint: {'center_x': .5, 'center_y': .35}
        opacity: 0

    MDLinearProgressIndicator:
        id: progress_indicator
        opacity: 0
        size_hint: .8, None
        type: "determinate"
        pos_hint: {'center_x': .5, 'center_y': .25}
        value: 0
        indicator_color: 'mediumpurple'
'''

class ParserApp(MDApp):

    def build(self):
        MDApp.title = "Parser"
        self.theme_cls.material_style = "M3"
        self.theme_cls.theme_style = "Dark"
        self.theme_cls.primary_palette = "Lightslategrey"
        Window.size = (400, 500)
        return Builder.load_string(KV)

    def button_press(self):        
        progress_indicator = self.root.ids.progress_indicator       
        user_input_value = self.root.ids.input_field.text.strip()
        if user_input_value != '':
            self.deactivate_widgets()
            
            # 定义子线程任务的包装函数
            def thread_task():
                try:
                    market_parse(user_input_value, progress_indicator)
                finally:
                    # 确保无论任务是否异常，都在主线程恢复UI
                    Clock.schedule_once(lambda dt: self.activate_widgets())
            
            thread = threading.Thread(target=thread_task)
            thread.start()

    def deactivate_widgets(self):
        self.root.ids.search_button.disabled = True
        self.root.ids.input_field.disabled = True        
        self.root.ids.search_button.opacity = 0
        self.root.ids.load_indicator.opacity = 1
        self.root.ids.progress_indicator.opacity = 1

    def activate_widgets(self):
        self.root.ids.search_button.disabled = False
        self.root.ids.input_field.disabled = False        
        self.root.ids.search_button.opacity = 1
        self.root.ids.load_indicator.opacity = 0
        self.root.ids.progress_indicator.opacity = 0
        # 重置进度条值
        self.root.ids.progress_indicator.value = 0

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

关键说明 #

• Clock.schedule_once(func, dt)：将func调度到Kivy主循环的下一次迭代执行，确保UI操作在主线程完成。
• try...finally：保证即使market_parse抛出异常，UI也能恢复正常状态，避免界面卡死。
• 进度条更新：子线程中不能直接修改progress_indicator.value，必须通过Clock.schedule_once包装，否则会导致Kivy崩溃或UI异常。

内容的提问来源于stack exchange，提问作者Максим Игрок