树莓派中Python Tkinter守护线程程序结束后无法终止问题

问题描述 #

在树莓派上运行Python程序时出现异常：为优化用户体验，程序运行时隐藏控制台，同时启动一个Tkinter状态窗口，用于提示程序运行状态，并提供无需控制台/任务管理器即可终止程序的入口。为实现程序完成后窗口自动关闭，将窗口所在线程设为守护线程。

主文件代码：

import threading

import Background_Window # 包含状态窗口代码的文件

t1 = threading.Thread(target=Background_Window.Background_Status_Window)    
t1.daemon = True
t1.start()

# 其他业务代码

状态窗口代码（Background_Window.py）：

from tkinter import *
import os
import signal

def Background_Status_Window():
    
    def disable_event():                
        def yes_button():
            child_prompt.destroy()
            root.destroy()
            os.kill(os.getpid(), signal.SIGINT)

        def no_button():
            child_prompt.destroy()
        
        child_prompt = Toplevel(root)
        child_prompt.title("Warning")
        Warning_message = Label(child_prompt, text='Do you really want to close this window?')
        Warning_message.place(relx=0.5, rely=0.2, anchor=CENTER)
        button3 = Button(child_prompt, text="Yes", command=yes_button)
        button3.place(relx=0.3, rely=0.7, anchor=CENTER)
        button4 = Button(child_prompt, text="No", command=no_button)
        button4.place(relx=0.7, rely=0.7, anchor=CENTER)


    root = Tk()

    Info_Text = Label(root, text='The programme is running. \n If you need to terminate it, close this window.')
    Info_Text.place(relx=0.5, rely=0.5, anchor=CENTER)

    root.protocol("WM_DELETE_WINDOW", disable_event)
    root.mainloop()

该实现在Windows环境下可正常运行，但在树莓派上，主程序代码执行完毕后，状态窗口会冻结，只能通过任务管理器或键盘中断关闭。排查确认：主程序执行完毕前窗口可正常响应终止操作，问题出在Python尝试终止守护线程时，且终端无报错信息。

问题原因 #

• 守护线程特性限制：Python中所有非守护线程结束后，解释器会直接退出，不会等待守护线程完成资源清理。Tkinter的mainloop()事件循环依赖解释器主线程的系统资源，主线程退出后，守护线程中的Tkinter循环失去底层支持，导致窗口冻结。
• 跨平台机制差异：Windows和Linux（树莓派基于Linux）的线程调度、进程退出逻辑不同。Windows下守护线程的Tkinter窗口能被系统正确回收，但Linux下主线程退出会直接终止守护线程执行，Tkinter无法正常销毁窗口资源，引发无响应。
• 信号调用隐患：在守护线程中调用os.kill(os.getpid(), signal.SIGINT)，当主线程已退出时，信号处理无法正常触发，反而导致进程残留，窗口冻结。

解决方案 #

方案1：用非守护线程+退出标记替代守护线程 #

取消窗口线程的守护属性，在主线程中设置退出标记，业务代码执行完毕后主动通知窗口线程关闭，确保资源正常清理。

修改主文件代码：

import threading
import Background_Window

# 创建全局退出标记，用于通知窗口关闭
exit_flag = threading.Event()

def run_window():
    Background_Window.Background_Status_Window(exit_flag)

t1 = threading.Thread(target=run_window)
t1.start()

# 其他业务代码
# ... 业务代码执行完毕后，触发退出标记
exit_flag.set()
# 等待窗口线程正常结束
t1.join()

修改Background_Window.py代码，增加退出标记监听：

from tkinter import *
import os
import threading

def Background_Status_Window(exit_flag=None):
    
    def disable_event():                
        def yes_button():
            child_prompt.destroy()
            root.destroy()
            # 直接终止进程，避免依赖主线程
            os._exit(0)

        def no_button():
            child_prompt.destroy()
        
        child_prompt = Toplevel(root)
        child_prompt.title("Warning")
        Warning_message = Label(child_prompt, text='Do you really want to close this window?')
        Warning_message.place(relx=0.5, rely=0.2, anchor=CENTER)
        button3 = Button(child_prompt, text="Yes", command=yes_button)
        button3.place(relx=0.3, rely=0.7, anchor=CENTER)
        button4 = Button(child_prompt, text="No", command=no_button)
        button4.place(relx=0.7, rely=0.7, anchor=CENTER)

    def check_exit():
        if exit_flag and exit_flag.is_set():
            root.destroy()
            os._exit(0)
        # 每隔100毫秒检查一次退出标记
        root.after(100, check_exit)

    root = Tk()

    Info_Text = Label(root, text='The programme is running. \n If you need to terminate it, close this window.')
    Info_Text.place(relx=0.5, rely=0.5, anchor=CENTER)

    root.protocol("WM_DELETE_WINDOW", disable_event)
    # 启动退出标记检查
    if exit_flag:
        check_exit()
    root.mainloop()

方案2：替换信号调用为直接进程终止 #

将yes_button中的signal.SIGINT调用替换为os._exit(0)，直接终止整个进程，避免信号处理的跨平台问题：

def yes_button():
    child_prompt.destroy()
    root.destroy()
    os._exit(0)  # 强制终止进程，比信号调用更可靠

方案3：避免在守护线程中运行Tkinter #

Tkinter的GUI线程优先使用主线程或非守护线程，确保资源能正常清理。如果需要隐藏控制台，可通过树莓派的启动方式实现：

• 使用pythonw（若已安装）启动程序
• 创建.desktop快捷方式启动程序，无需手动隐藏控制台

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