如何用Python Telebot实现全屏图片显隐？遇RuntimeError问题

尝试用Python的Telebot库实现通过指令控制全屏显示和隐藏图片，先后编写了带threading和不带threading的两种代码，但均出现报错。

带threading的代码及报错 #

import threading
import tkinter as tk
from PIL import Image, ImageTk
import tempfile
import os

root = None
blur_thread = None

def kaburkan(image_path):
    global root
    if root:
        root.after(0, root.destroy)  # Schedule the destruction on the main thread
    root = tk.Tk()
    root.attributes('-fullscreen', True)
    root.attributes('-topmost', True)
    image = Image.open(image_path)
    image = ImageTk.PhotoImage(image)
    screen_width = root.winfo_screenwidth()
    screen_height = root.winfo_screenheight()
    label = tk.Label(root, image=image)
    label.place(x=0, y=0, relwidth=1, relheight=1)
    # root.protocol("WM_DELETE_WINDOW", lambda: None)  # Disable close button
    root.mainloop()

def blur_thread_func(image_path):
    kaburkan(image_path)

def unblur():
    global blur_thread
    if blur_thread:
        blur_thread.join()  # Wait for the thread to finish
        blur_thread = None

# ... (the rest of your code)

@bot.message_handler(func=lambda message: True)
def handle_message(message):
    global blur_thread
    # ... (your existing code)

    elif text.lower() == "blur":
        screenshot_file = tempfile.NamedTemporaryFile(suffix='.png', delete=False)
        im = ImageGrab.grab()
        im.save(screenshot_file.name)

        # Start a new thread for kaburkan
        blur_thread = threading.Thread(target=blur_thread_func, args=(screenshot_file.name,))
        blur_thread.start()

        bot.send_message(chat_id, "Blur")

    elif text.lower() == "unblur":
        unblur()
        bot.send_message(chat_id, "Unblur")

报错信息：RuntimeError: 主线程不在主循环中

不带threading的代码及报错 #

去掉threading后，代码仅能正常运行一次，之后触发相同报错：

import tkinter as tk
from PIL import Image, ImageTk
import tempfile
import os

root = None

def kaburkan(image_path):
    global root
    if root:
        root.destroy()
    root = tk.Tk()
    root.attributes('-fullscreen', True)
    root.attributes('-topmost', True)
    image = Image.open(image_path)
    image = ImageTk.PhotoImage(image)
    screen_width = root.winfo_screenwidth()
    screen_height = root.winfo_screenheight()
    label = tk.Label(root, image=image)
    label.place(x=0, y=0, relwidth=1, relheight=1)
    # root.protocol("WM_DELETE_WINDOW", lambda: None)  # Disable close button
    root.mainloop()

def unblur():
    if root:
        root.after(0, root.destroy)

# ... (the rest of your code)

@bot.message_handler(func=lambda message: True)
def handle_message(message):
    # ... (your existing code)

    elif text.lower() == "blur":
        screenshot_file = tempfile.NamedTemporaryFile(suffix='.png', delete=False)
        im = ImageGrab.grab()
        im.save(screenshot_file.name)
        kaburkan(screenshot_file.name)
        screenshot_file.close()
        bot.send_message(chat_id, "Blur")

    elif text.lower() == "unblur":
        unblur()
        bot.send_message(chat_id, "Unblur")

报错信息：RuntimeError: 主线程不在主循环中

解决方案 #

问题本质 #

Tkinter的所有GUI操作必须在主线程中执行，之前的两种写法都违反了这个规则：

• 带threading版本：在子线程中创建Tk实例并启动mainloop，Tkinter禁止非主线程操作GUI
• 不带threading版本：调用kaburkan时会阻塞Telebot的事件循环，Tk实例销毁后无法再次创建新实例

修复后的完整代码 #

import tkinter as tk
from PIL import Image, ImageTk, ImageGrab
import tempfile
import telebot

# 替换为你的Telebot Token
bot = telebot.TeleBot("YOUR_BOT_TOKEN")

root = None
image_label = None

def init_overlay():
    """初始化全屏覆盖窗口，仅执行一次"""
    global root, image_label
    root = tk.Tk()
    root.attributes('-fullscreen', True)
    root.attributes('-topmost', True)
    root.attributes('-alpha', 1.0)  # 可调整透明度
    root.overrideredirect(True)  # 隐藏窗口边框和标题栏
    image_label = tk.Label(root)
    image_label.place(x=0, y=0, relwidth=1, relheight=1)
    # 用循环更新窗口，避免阻塞Telebot事件循环
    def update_gui():
        root.update_idletasks()
        root.update()
        root.after(10, update_gui)
    update_gui()
    root.withdraw()  # 初始化后先隐藏窗口

def show_blur_image(image_path):
    """显示全屏截图"""
    global image_label
    image = Image.open(image_path)
    # 缩放图片适配屏幕
    screen_w = root.winfo_screenwidth()
    screen_h = root.winfo_screenheight()
    image = image.resize((screen_w, screen_h), Image.Resampling.LANCZOS)
    photo = ImageTk.PhotoImage(image)
    image_label.config(image=photo)
    image_label.image = photo  # 保留引用防止图片被垃圾回收
    root.deiconify()  # 显示窗口

def hide_blur_image():
    """隐藏全屏窗口"""
    if root:
        root.withdraw()

@bot.message_handler(func=lambda message: True)
def handle_message(message):
    chat_id = message.chat.id
    text = message.text.strip().lower()

    if text == "blur":
        # 临时保存截图
        with tempfile.NamedTemporaryFile(suffix='.png', delete=False) as f:
            ImageGrab.grab().save(f.name)
        # 调度到主线程执行GUI操作
        root.after(0, show_blur_image, f.name)
        bot.send_message(chat_id, "已开启全屏覆盖")

    elif text == "unblur":
        root.after(0, hide_blur_image)
        bot.send_message(chat_id, "已关闭全屏覆盖")

# 主线程初始化Tkinter
init_overlay()
# 启动Telebot轮询，保持后台运行
bot.infinity_polling(non_stop=True)

核心修改点 #

1. 主线程独占GUI操作：所有Tkinter操作都在主线程执行，用root.after(0, func, args)调度更新，避免跨线程问题
2. 非阻塞窗口循环：用update循环代替mainloop，既保证Tkinter正常运行，又不阻塞Telebot的事件循环
3. 复用窗口实例：用withdraw()隐藏窗口而非销毁，后续直接调用deiconify()显示，避免重复创建Tk实例的报错
4. 保留图片引用：通过image_label.image = photo防止PIL图片被垃圾回收，避免显示空白

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