Tkinter Treeview无法显示MySQL读取的图片问题求助

核心问题分析 #

多条数据时图片不显示，多半是图片对象被Python垃圾回收机制回收了。Tkinter（包括Custom Tkinter）的图片对象如果没被持久化引用，代码执行完就会被销毁，导致Treeview里的图片占位符空掉。另外直接转Blob插入Treeview的方式没处理好图片对象的生命周期，也会引发这个问题。

针对性解决方案 #

1. 保存图片引用，避免被回收 #

建一个全局或者类级别的列表/字典，专门存所有要显示的图片对象，保证它们一直被引用：

# 全局存图片引用，防止被回收
image_references = []

def load_images_from_db():
    # 假设已经从MySQL读到blob数据列表 blobs
    for blob_data in blobs:
        # 把Blob转成临时图片对象
        img = tk.PhotoImage(data=blob_data)
        # 存下引用
        image_references.append(img)
        # 插入Treeview
        tree.insert('', tk.END, values=('数据1', '数据2', img))

如果是类结构的GUI，把image_references作为类的属性：

class App(customtkinter.CTk):
    def __init__(self):
        super().__init__()
        self.image_references = []  # 类属性存引用
        self.tree = customtkinter.CTkTreeview(self, columns=('col1', 'col2', 'col3'))
        # ... 其他初始化代码

    def load_images(self):
        # 读取MySQL Blob数据
        cursor.execute("SELECT id, name, image FROM table_name")
        rows = cursor.fetchall()
        for row in rows:
            img_data = row[2]
            img = tk.PhotoImage(data=img_data)
            self.image_references.append(img)
            self.tree.insert('', 'end', values=(row[0], row[1], img))

2. 优化临时文件处理（必须用临时文件的情况） #

如果是先把Blob存到临时目录再加载，要保证每个文件路径唯一，加载后的图片对象也得存引用：

import tempfile
import os

def load_images_via_temp():
    image_references = []
    cursor.execute("SELECT id, name, image FROM table_name")
    rows = cursor.fetchall()
    for idx, row in enumerate(rows):
        img_data = row[2]
        # 创建唯一临时文件
        with tempfile.NamedTemporaryFile(delete=False, suffix='.png') as tmp:
            tmp.write(img_data)
            tmp_path = tmp.name
        # 加载图片
        img = tk.PhotoImage(file=tmp_path)
        image_references.append(img)
        # 插入Treeview
        tree.insert('', tk.END, values=(row[0], row[1], img))
        # 可选：程序退出时清理临时文件
        self.protocol("WM_DELETE_WINDOW", lambda: [os.unlink(tmp_path), self.destroy()])

3. 检查Treeview列配置 #

确保Treeview的图片列已经正确设置，能显示图片：

# 初始化Treeview时指定列，图片列宽度要够
tree = customtkinter.CTkTreeview(root, columns=('ID', 'Name', 'Image'), show='headings')
tree.heading('ID', text='ID')
tree.heading('Name', text='名称')
tree.heading('Image', text='图片')
tree.column('Image', width=100)  # 设置合适宽度

常见坑点排查 #

• 别在循环里临时创建图片对象却不保存引用，循环结束后对象会被回收
• 如果用PIL.ImageTk.PhotoImage处理JPG等格式，同样要保存引用，还要确保PIL安装正确
• 检查MySQL读取的Blob数据是否完整，避免数据截断导致图片加载失败

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