Tkinter字节图片弹窗二次弹出报错：_tkinter.TclError: image不存在

问题现象 #

首次弹出含字节流图片的Tkinter弹窗可正常显示，关闭后再次弹出时触发错误：_tkinter.TclError: image "pyimage1" doesn't exist，尝试将图片对象存入列表防止垃圾回收，但未解决问题。

问题根源 #

1. 重复创建主窗口：每次收到command事件时都重新实例化Tk()，导致Tcl上下文混乱，图片对象与旧主窗口绑定，旧窗口销毁后图片引用失效。
2. 图片复用方式错误：尝试用tk_image[0].paste(image)复用PhotoImage对象，但ImageTk.PhotoImage不支持该操作，实际未更新图片，反而引发引用混乱。
3. 线程操作风险：直接在子线程中创建Tkinter组件，Tkinter非线程安全，易引发未知错误。

修复后的代码 #

import PIL
import socketio
import json
import io
from PIL import ImageTk, Image
import threading
import tkinter as tk

# 全局主窗口和图片引用容器
root = None
tk_images = []

sio = socketio.Client()

@sio.event
def connect():
    print('Connected to server')

@sio.event
def disconnect():
    print('Disconnected from server')

def show_image_popup(image_bytes, title):
    # 借助after方法将弹窗创建逻辑移交主线程，规避线程安全问题
    def create_popup():
        try:
            global tk_images
            popup = tk.Toplevel(root)
            popup.title(title)
            popup.geometry("400x400")
            
            # 加载并处理字节流图片
            image = PIL.Image.open(io.BytesIO(image_bytes))
            image = image.resize((400, 400))
            # 创建新的PhotoImage对象，更新全局引用
            photo = ImageTk.PhotoImage(image)
            if len(tk_images) > 0:
                tk_images[0] = photo
            else:
                tk_images.append(photo)
            
            # 创建标签并绑定图片引用（双重保险防止回收）
            image_label = tk.Label(popup, image=photo)
            image_label.pack()
            image_label.image = photo
            
            # 关闭弹窗时仅销毁弹窗本身
            popup.protocol("WM_DELETE_WINDOW", popup.destroy)
        except Exception as e:
            print(e)
            sio.emit("msg", str(e))
    
    root.after(0, create_popup)

@sio.on('command')
def command(data):
    cmd_data = json.loads(data)
    reqcmd = cmd_data["command"]
    args = cmd_data["args"]
    flags = cmd_data["flags"]
    
    args0 = args[0] if len(args) > 0 else ""
    flags0 = flags[0] if len(flags) > 0 else ""
    flags1 = flags[1] if len(flags) > 1 else ""
    
    if reqcmd == "popup" and flags0 == "img":
        # 子线程仅负责触发弹窗创建逻辑
        threading.Thread(target=show_image_popup, args=(flags1, args0)).start()

if __name__ == "__main__":
    # 仅初始化一次主窗口并隐藏
    root = tk.Tk()
    root.withdraw()
    sio.connect('你的服务器地址')
    root.mainloop()
    sio.wait()

关键修改说明 #

• 全局单例主窗口：程序启动时仅创建一次root，避免重复实例化导致的Tcl上下文冲突。
• 正确维护图片引用：每次弹窗都创建新的PhotoImage对象，同时更新全局列表和标签自身的引用，彻底避免垃圾回收问题。
• 线程安全处理：子线程仅触发弹窗创建信号，实际的Tkinter组件操作通过after方法移交主线程执行。
• 简化关闭逻辑：关闭弹窗时仅销毁弹窗，不额外销毁标签，避免提前破坏图片引用链。

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