Tkinter图片在非__main__文件调用时加载失败的原因排查

问题重现 #

单独运行模态窗口模块（auth.py）时图片显示正常，但从其他模块（如header.py）调用该模块时，抛出_tkinter.TclError: image "pyimage2" doesn't exist错误。

核心原因 #

Tkinter中每个tk.Tk()实例对应一个独立的Tcl解释器，图片对象会绑定到创建它的解释器。当你在auth模块中单独创建tk.Tk()作为根窗口，而主程序（main.py）已经存在另一个tk.Tk()实例时，图片会被绑定到auth模块的Tcl解释器，但canvas属于主程序的解释器，导致主程序找不到该图片资源。

解决方案 #

1. 统一应用的根窗口实例 #

修改auth模块的AuthWindow类，不再自行创建新的tk.Tk()，而是复用主程序已存在的根窗口，或在单独测试时才创建：

import tkinter as tk
from utilities import load_asset

class AuthWindow:
    def __init__(self, parent=None):
        # 优先使用传入的父窗口，其次用全局默认根窗口，最后才创建新窗口
        self.root = parent or tk._default_root or tk.Tk()
        # 创建模态窗口作为根窗口的Toplevel
        self.top = tk.Toplevel(self.root)
        self.top.transient(self.root)  # 绑定到父窗口，确保模态行为
        self.top.grab_set()  # 锁定焦点为当前模态窗口
        self._setup_ui()

    def _setup_ui(self):
        # 基于self.top创建canvas和UI元素
        self.canvas = tk.Canvas(self.top, ...)
        # 加载图片时指定master为当前模态窗口的父根
        self.image_1 = tk.PhotoImage(file=load_asset("logo.png", assetArea="auth"), master=self.root)
        self.canvas.create_image(170, 24, image=self.image_1)
        # ... 其他UI代码

    def request_auth(self):
        # 处理认证逻辑，最后返回结果
        self.root.wait_window(self.top)
        # 替换为你的认证结果判断
        return self.auth_success

# 单独测试时的入口
if __name__ == "__main__":
    root = tk.Tk()
    root.withdraw()  # 隐藏主窗口，只显示模态窗口
    auth_win = AuthWindow(parent=root)
    root.mainloop()

2. 调整外部调用方式 #

在header.py中调用AuthWindow时，传入主程序的根窗口实例（可以从canvas获取）：

def show_tab(self, button):
    tab = None
    if button == self.ButtonAdmin:
        # 从canvas获取根窗口实例传入AuthWindow
        if auth.AuthWindow(parent=self.canvas.winfo_toplevel()).request_auth():
            tab = tabs.Admin
    # ... 其他逻辑

3. 确保图片对象不被垃圾回收 #

虽然你已经将图片绑定到self.image_1，但仍需注意：如果UI元素（如canvas）属于不同的Tk实例，即便引用存在也会失效。通过统一根窗口实例，这个问题会自然解决。

验证 #

• 单独运行auth.py：测试模态窗口功能正常，图片显示。
• 从main.py运行：调用auth模块的模态窗口时，图片正常加载，不再抛出错误。

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