切换GUI时出现check_dpi_scaling、click_animation等无效命令错误求助

问题描述 #

开发了一款质谱数据处理程序，工作流程如下：

• 向用户展示序列列表，要求从中选择一个序列；
• 选定分析序列后，展示原始数据的绘图供分析。

在序列选择GUI与原始数据GUI切换时，会出现以下晦涩错误：

invalid command name "2073977167560update"
    while executing
"2073977167560update"
    ("after" script)
invalid command name "2073972183304check_dpi_scaling"
    while executing
"2073972183304check_dpi_scaling"
    ("after" script)

此前遇到过类似错误，当时是因为在tkinter中使用matplotlib.pyplot而非matplotlib.figure导致的。这次怀疑问题与GUI切换逻辑有关，但无法定位具体错误点。

以下是最小可复现示例代码：

from tkinter import ttk
import customtkinter as ctk
import matplotlib.figure as Figure
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg

def create_first_gui():
    window = ctk.CTk()
    window.title('First GUI')

    tree = ttk.Treeview(window)
    tree["columns"]=("one","two")
    tree.column("#0", width=100)
    tree.column("one", width=100)
    tree.column("two", width=100)
    tree.heading("#0",text="Column A")
    tree.heading("one", text="Column B")
    tree.heading("two", text="Column C")

    tree.insert("", 0, text="Line 1", values=("Random 1","Random 2"))

    tree.pack()

    button = ctk.CTkButton(window, text="Proceed to Second GUI", command=window.destroy)
    button.pack()

    window.mainloop()

def create_second_gui():
    window = ctk.CTk()
    window.title('Second GUI')

    fig = Figure.Figure(figsize=(5, 4), dpi=100)
    t = [i/100 for i in range(100)]
    fig.add_subplot(111).plot(t, [i**2 for i in t])

    canvas = FigureCanvasTkAgg(fig, master=window)
    canvas.draw()
    canvas.get_tk_widget().pack(side=ctk.TOP, fill=ctk.BOTH, expand=1)

    window.mainloop()

create_first_gui()
create_second_gui()

运行上述脚本还会额外出现click_animation相关错误：

invalid command name "2224692384648update"
    while executing
"2224692384648update"
    ("after" script)
invalid command name "2224697676232check_dpi_scaling"
    while executing
"2224697676232check_dpi_scaling"
    ("after" script)
invalid command name "2224697708616_click_animation"
    while executing
"2224697708616_click_animation"
    ("after" script)

错误原因 #

这些错误的本质是：当销毁第一个CTk窗口时，CustomTkinter组件（比如CTkButton）和Matplotlib的Tk后台已经通过Tkinter的after方法注册了延迟执行的回调脚本（比如按钮点击动画、DPI缩放检查、绘图更新）。但窗口销毁后，这些回调脚本仍会被触发，此时对应的组件对象已经不存在，Tkinter无法找到以组件内存地址命名的命令（错误信息中的数字就是组件的内存标识符），从而抛出"invalid command name"错误。

解决方法 #

最可靠的方案是采用单窗口页面切换的模式，避免销毁整个窗口后重新创建新窗口。具体实现如下：

修改后的示例代码 #

from tkinter import ttk
import customtkinter as ctk
import matplotlib.figure as Figure
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg

class App(ctk.CTk):
    def __init__(self):
        super().__init__()
        self.title("质谱数据处理程序")
        
        # 创建两个页面Frame
        self.page1 = ctk.CTkFrame(self)
        self.page2 = ctk.CTkFrame(self)
        
        # 初始化第一个页面
        self.init_page1()
        # 初始化第二个页面
        self.init_page2()
        
        # 默认显示第一个页面
        self.show_page(self.page1)
    
    def init_page1(self):
        # 序列列表Treeview
        tree = ttk.Treeview(self.page1)
        tree["columns"]=("one","two")
        tree.column("#0", width=100)
        tree.column("one", width=100)
        tree.column("two", width=100)
        tree.heading("#0",text="Column A")
        tree.heading("one", text="Column B")
        tree.heading("two", text="Column C")
        tree.insert("", 0, text="Line 1", values=("Random 1","Random 2"))
        tree.pack(pady=20)
        
        # 切换页面按钮
        button = ctk.CTkButton(self.page1, text="Proceed to Second GUI", command=lambda: self.show_page(self.page2))
        button.pack(pady=10)
    
    def init_page2(self):
        # Matplotlib绘图
        fig = Figure.Figure(figsize=(5, 4), dpi=100)
        t = [i/100 for i in range(100)]
        fig.add_subplot(111).plot(t, [i**2 for i in t])
        
        canvas = FigureCanvasTkAgg(fig, master=self.page2)
        canvas.draw()
        canvas.get_tk_widget().pack(side=ctk.TOP, fill=ctk.BOTH, expand=1)
        
        # 返回按钮
        button = ctk.CTkButton(self.page2, text="Back to Sequence List", command=lambda: self.show_page(self.page1))
        button.pack(pady=10)
    
    def show_page(self, page):
        # 隐藏所有页面
        for frame in [self.page1, self.page2]:
            frame.pack_forget()
        # 显示目标页面
        page.pack(fill=ctk.BOTH, expand=True)

if __name__ == "__main__":
    app = App()
    app.mainloop()

方案优势 #

1. 避免了窗口销毁后残留的after回调问题，彻底消除错误；
2. 界面切换更流畅，无需重新创建整个窗口；
3. 代码结构更清晰，便于后续扩展更多功能页面。

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