Python Tkinter报错‘pyimage5不存在’，MVC重构后异常

问题描述 #

使用Python 3.9 + PyCharm开发，原本运行正常的代码在重构为MVC架构（拆分独立视图文件）后，出现如下报错：

"C:\Users\santh\miniconda3\lib\tkinter\__init__.py", line 2572, in __init__
    self.tk.call(
_tkinter.TclError: image "pyimage5" doesn't exist.

相关代码片段：

script_dir = os.path.dirname(__file__)  # <-- absolute dir the script is in
print(script_dir)
rel_path_play = "images/play_pause.ico"
rel_path_stop = "images/stop.png"
rel_path_forward = "images/forward.png"
rel_path_rewind = "images/rewind.png"
abs_file_path_play = os.path.join(script_dir, rel_path_play)
abs_file_path_stop = os.path.join(script_dir, rel_path_stop)
abs_file_path_forward = os.path.join(script_dir, rel_path_forward)
abs_file_rewind = os.path.join(script_dir, rel_path_rewind)
self.play_pause_btn_img = Image.open(abs_file_path_play)
self.stop_btn_img = Image.open(abs_file_path_stop)
self.forward_btn_img = Image.open(abs_file_path_forward)
self.rewind_btn_img = Image.open(abs_file_rewind)

# Resize the Image
self.resized_play_pause_img = self.play_pause_btn_img.resize((50, 50), Image.ANTIALIAS)
self.resized_play_pausebtn_img = ImageTk.PhotoImage(self.resized_play_pause_img)

self.resized_play_pause_img.image = self.resized_play_pause_img

self.resized_stop_img = self.stop_btn_img.resize((50, 50), Image.ANTIALIAS)
self.resized_stopbtn_img = ImageTk.PhotoImage(self.resized_stop_img)

self.resized_forward_img = self.forward_btn_img.resize((50, 50), Image.ANTIALIAS)
self.resized_forwardbtn_img = ImageTk.PhotoImage(self.resized_forward_img)

self.resized_rewind_img = self.rewind_btn_img.resize((50, 50), Image.ANTIALIAS)
self.resized_rewindbtn_img = ImageTk.PhotoImage(self.resized_rewind_img)

# Create Player Control Frame
self.control_frame = Frame(self.root)

self.play_pause_btn = Button(self.control_frame, image=self.resized_play_pausebtn_img, borderwidth=0,
                             command=lambda: self.play_pause())

核心原因 #

重构MVC后，多个视图文件可能重复创建Tk根窗口，或者PhotoImage对象被Python垃圾回收机制回收，导致Tk无法找到对应的图像资源。

有效解决方法 #

1. 确保全局只有一个Tk根实例 #

• 根窗口Tk()必须仅在主入口文件中创建一次，其他视图文件通过传入根窗口实例或使用Toplevel()创建子窗口，避免重复初始化Tcl环境。
  主入口示例：

  from tkinter import Tk
  from views.control_view import ControlView
  
  if __name__ == "__main__":
      root = Tk()
      control_view = ControlView(root)
      root.mainloop()
  

  子视图类接收root参数：

  class ControlView:
      def __init__(self, root):
          self.root = root
          # 后续所有控件基于该root创建
  

2. 修正PhotoImage引用，防止被垃圾回收 #

• 你的代码中存在引用错误：self.resized_play_pause_img.image = self.resized_play_pause_img是将原始PIL图像赋值给自己，而非保存ImageTk.PhotoImage的引用。
• 正确做法是将每个ImageTk.PhotoImage对象绑定到长期存在的实例属性或按钮实例上：

  # 修正播放按钮的引用
  self.resized_play_pausebtn_img = ImageTk.PhotoImage(self.resized_play_pause_img)
  self.play_pause_btn = Button(self.control_frame, image=self.resized_play_pausebtn_img, borderwidth=0,
                               command=lambda: self.play_pause())
  # 将图像引用绑定到按钮实例，避免被回收
  self.play_pause_btn.image = self.resized_play_pausebtn_img
  
  # 其他按钮同理处理
  self.resized_stopbtn_img = ImageTk.PhotoImage(self.resized_stop_img)
  self.stop_btn = Button(self.control_frame, image=self.resized_stopbtn_img, borderwidth=0)
  self.stop_btn.image = self.resized_stopbtn_img
  

• 也可以统一用字典保存所有图像引用：

  self.image_refs = {}
  self.image_refs["play"] = ImageTk.PhotoImage(self.resized_play_pause_img)
  self.play_pause_btn = Button(self.control_frame, image=self.image_refs["play"], ...)
  

3. 确认图像路径正确性 #

• 重构后__file__的路径可能因视图文件在子目录而变化，打印abs_file_path_play确认路径是否正确，确保图像文件存在。
• 改用pathlib更直观处理路径：

  from pathlib import Path
  script_dir = Path(__file__).parent
  abs_file_path_play = script_dir / "images" / "play_pause.ico"
  

验证步骤 #

1. 检查代码中是否仅存在一个Tk()实例
2. 确认所有ImageTk.PhotoImage对象都被实例属性或按钮实例持有引用
3. 验证图像文件路径正确，文件未缺失

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