在独立线程启动多tkinter应用遇_tkinter.TclError错误求助

尝试在独立线程中启动多个Tkinter类实例，每个实例对应一个通过Xephyr启动的独立X服务器，但第二个窗口出现时总会抛出_tkinter.TclError: image "pyimage2" doesn't exist错误。原以为它们是完全独立的实例，但实际并非如此。

验证代码（PoC） #

import subprocess, threading, time
import tkinter
from PIL import Image, ImageTk


class App:
    def __init__(self, display: str):
        self.root = tkinter.Tk(screenName=display)
        self.background_image = Image.new("RGB", (200, 200), (200, 200, 200))
        self.background = ImageTk.PhotoImage(self.background_image)
        self.label_background = tkinter.Label(
            self.root, image=self.background, borderwidth=0
        )
        self.root.mainloop()


class X(threading.Thread):
    def __init__(self, display):
        super().__init__()
        self.display = display
        subprocess.Popen(["Xephyr", self.display])
        # 等待X服务器就绪
        while (
            subprocess.run(
                ["xset", "-q", "-display", self.display],
                stdout=subprocess.DEVNULL,
                stderr=subprocess.DEVNULL,
            ).returncode
            != 0
        ):
            time.sleep(0.01)

    def run(self):
        # 阻塞调用
        self.app = App(self.display)


x1 = X(":1")
x1.start()
x2 = X(":2")
x2.start()
x2.join()

运行错误输出 #

$ python3 tkinter_test.py
Exception in thread Thread-2:
Traceback (most recent call last):
  File "/usr/lib/python3.10/threading.py", line 1016, in _bootstrap_inner
    self.run()
  File "/home/user/pyrdp/tkinter_test.py", line 35, in run
    self.app = App(self.display)
  File "/home/user/pyrdp/tkinter_test.py", line 11, in __init__
    self.label_background = tkinter.Label(
  File "/usr/lib/python3.10/tkinter/__init__.py", line 3187, in __init__
    Widget.__init__(self, master, 'label', cnf, kw)
  File "/usr/lib/python3.10/tkinter/__init__.py", line 2601, in __init__
    self.tk.call(
_tkinter.TclError: image "pyimage2" doesn't exist

问题原因与解决方案 #

问题根源 #

Tkinter依赖Tcl解释器，单个进程中的所有Tkinter实例默认共享同一个Tcl解释器上下文。即使指定了不同的X display，第二个线程创建的PhotoImage会被错误注册到第一个Tcl解释器的命名空间，导致第二个Tk实例找不到对应的image ID，从而抛出错误。同时Tkinter本身并非线程安全，多线程操作容易引发各类隐性问题。

解决方案 #

方案1：使用多进程替代多线程（推荐）

每个进程拥有独立的Tcl解释器，完全隔离资源，从根本上避免共享上下文的冲突。修改后的代码如下：

import subprocess, multiprocessing, time
import tkinter
from PIL import Image, ImageTk


class App:
    def __init__(self, display: str):
        self.root = tkinter.Tk(screenName=display)
        self.background_image = Image.new("RGB", (200, 200), (200, 200, 200))
        self.background = ImageTk.PhotoImage(self.background_image)
        self.label_background = tkinter.Label(
            self.root, image=self.background, borderwidth=0
        )
        self.label_background.pack()  # 补充pack显示标签
        self.root.mainloop()


def run_app(display):
    subprocess.Popen(["Xephyr", display])
    # 等待X服务器就绪
    while (
        subprocess.run(
            ["xset", "-q", "-display", display],
            stdout=subprocess.DEVNULL,
            stderr=subprocess.DEVNULL,
        ).returncode != 0
    ):
        time.sleep(0.01)
    App(display)


if __name__ == "__main__":
    p1 = multiprocessing.Process(target=run_app, args=(":1",))
    p1.start()
    p2 = multiprocessing.Process(target=run_app, args=(":2",))
    p2.start()
    p2.join()

方案2：为每个Tk实例创建独立Tcl解释器（线程方案）

如果必须使用线程，可以手动为每个Tk实例初始化独立的Tcl解释器，强制隔离上下文：

import subprocess, threading, time
import tkinter
from PIL import Image, ImageTk


class App:
    def __init__(self, display: str):
        # 创建独立的Tcl解释器
        self.tcl = tkinter.Tcl()
        self.root = tkinter.Tk(screenName=display, tcl=self.tcl)
        self.background_image = Image.new("RGB", (200, 200), (200, 200, 200))
        # 明确指定PhotoImage的master为当前root，绑定到对应Tcl上下文
        self.background = ImageTk.PhotoImage(self.background_image, master=self.root)
        self.label_background = tkinter.Label(
            self.root, image=self.background, borderwidth=0
        )
        self.label_background.pack()
        self.root.mainloop()


class X(threading.Thread):
    def __init__(self, display):
        super().__init__()
        self.display = display
        subprocess.Popen(["Xephyr", self.display])
        while (
            subprocess.run(
                ["xset", "-q", "-display", self.display],
                stdout=subprocess.DEVNULL,
                stderr=subprocess.DEVNULL,
            ).returncode != 0
        ):
            time.sleep(0.01)

    def run(self):
        self.app = App(self.display)


x1 = X(":1")
x1.start()
x2 = X(":2")
x2.start()
x2.join()

注意：此方案仅解决当前image错误，但Tkinter的线程安全问题仍然存在，后续跨线程操作Tk组件仍可能出现异常，因此优先推荐多进程方案。

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