pynput监听鼠标触发Tkinter密码窗多线程报错问题求解

核心逻辑：将Tkinter运行在主线程，pynput鼠标监听放在后台子线程运行，两个线程通过线程安全的队列传递触发信号，完全避免跨线程操作Tkinter组件。

修改步骤 #

• 主线程优先初始化所有Tkinter相关实例，禁止在子线程中创建或调用任何Tkinter相关方法
• 用Python标准库的queue.Queue作为线程间通信媒介，子线程的鼠标监听回调触发时，仅向队列推送触发信号
• 主线程通过Tkinter内置的after()方法定时轮询队列，收到信号后在主线程内执行弹窗逻辑，完全符合Tkinter线程安全要求

代码修改示例 #

1. 调整入口逻辑（主线程运行Tkinter主循环） #

import queue
import threading
from access_detection import MouseMonitor
from password_prompt import PasswordPopup

# 全局线程安全通信队列
msg_queue = queue.Queue()

if __name__ == "__main__":
    # 先在主线程初始化所有Tk相关内容
    popup = PasswordPopup()
    # 初始化鼠标监听对象，传入通信队列
    monitor = MouseMonitor(msg_queue)
    # 将鼠标监听放到子线程启动
    monitor_thread = threading.Thread(target=monitor.detection_start, daemon=True)
    monitor_thread.start()

    # 主线程轮询队列的回调函数
    def check_queue():
        try:
            # 非阻塞获取队列信号
            signal = msg_queue.get_nowait()
            if signal == "show_popup":
                # 所有Tk操作都在主线程执行
                security_passed = popup.prompt_password()
                if not security_passed:
                    # 执行验证失败的逻辑
                    pass
                else:
                    # 验证成功，停止监听
                    monitor.stop_listener()
        except queue.Empty:
            pass
        # 每100ms轮询一次队列
        popup.win.after(100, check_queue)

    # 启动队列轮询
    check_queue()
    # 主线程运行Tk主循环
    popup.win.mainloop()

2. 修改access_detection.py的鼠标回调逻辑 #

def on_move_mouse(self, x, y):
    # 不要在回调中直接调用Tk相关方法，仅向队列推送信号
    self.msg_queue.put("show_popup")
    # 临时停止监听，避免重复触发弹窗
    self.mouse_monitor.stop()

def detection_start(self):
    with mouse_listener(on_move=self.on_move_mouse) as self.mouse_monitor:
        self.mouse_monitor.join()

3. 优化password_prompt.py的弹窗逻辑 #

将原来手动while True+update()的逻辑替换为Tk原生模态窗口逻辑，避免窗口卡死：

def confirm_passcode(self):
    self.access_granted = True
    # 验证完成后关闭窗口
    self.win.destroy()

def prompt_password(self) -> bool:
    # 初始化窗口组件
    entry = Entry(self.win, width=25, textvariable=self.password, show="*")
    entry.pack(pady=((int(self.win.winfo_screenheight()/2) - 100), 0))
    button = ttk.Button(self.win, text="Confirm Password", command=self.confirm_passcode)
    button.pack(pady=10)
    self.win.attributes('-fullscreen', True)
    self.win.attributes('-topmost', True)
    # 阻塞等待窗口关闭再返回结果
    self.win.wait_window()
    if self.access_granted == True:
        return True
    elif self.access_granted == False and self.access_attempts >= 3:
        return False

注意事项 #

• 所有Tkinter组件的创建、修改、方法调用必须全部在主线程执行，子线程仅负责事件触发，不碰任何UI操作
• queue.Queue是线程安全的，多线程读写不会出现数据冲突问题
• after方法是Tkinter官方推荐的跨线程交互方案，不会打断Tk主循环运行，也不会出现线程冲突报错

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