多线程结合Matplotlib触发RuntimeError：求保留多线程的解决方案

这个错误的核心原因很明确：所有Tkinter（包括CustomTkinter）的GUI操作，以及依赖Tk后端的Matplotlib交互（比如弹出图表窗口），都必须在主线程执行。你的代码里有几个关键问题导致了这个报错，我们一步步来修复：

问题1：用thread.join()阻塞了主线程 #

在openfile()方法里，你启动子线程后立刻调用了t.join()，这会让主线程完全停下来等待子线程完成——这不仅让多线程失去了意义（加载动画根本没法正常动），还会导致Tkinter的事件循环被打断，后续的GUI操作（比如显示热力图）找不到主线程的事件循环，直接报错。

问题2：加载动画的实现依赖全局变量+阻塞逻辑 #

play_gif()里用了全局countx，这在多次调用或多线程场景下很容易出问题；而且loading()方法里直接尝试一次性完成动画逻辑，没有结合Tkinter的after()机制让事件循环处理动画帧。

问题3：Matplotlib图表可能在非主线程触发 #

如果generate_heatmap()是在子线程中被调用的，plt.show()会尝试在非主线程启动Tk的事件循环，直接触发main thread is not in main loop错误。

解决方案：分步骤修复 #

1. 重构多线程逻辑，避免阻塞主线程 #

移除openfile()里的t.join()，改用Tkinter的after()方法定期检查子线程状态，让主线程的事件循环保持运行：

def openfile(self, force=''):
    name = force
    decision = ''
    if force == '':
        decision = filedialog.askopenfilename().split('/')
        name = decision[len(decision)-1].split('.')[0]

    if name == '':
        return
    
    self.btn_list.append(customtkinter.CTkButton(self.btn_frame, text=name, command=lambda: self.change_analysis(name)))      
    for x, btn in enumerate(self.btn_list):
        btn.grid(row=x+1, column=0, padx=10, pady=10)

    print('*'*20)
    self.t = th.Thread(target=self.getGraph, args=(decision, name,))
    self.t.start()
    # 启动加载动画，然后定期检查线程是否完成
    self.loading()
    self.check_thread_completion(name)
    print('*'*20)

# 新增方法：定期检查子线程状态
def check_thread_completion(self, name):
    if self.t.is_alive():
        # 每隔100ms检查一次，不要阻塞主线程
        self.after(100, lambda: self.check_thread_completion(name))
    else:
        # 子线程完成，恢复主界面并更新分析内容
        self.loading_frame.grid_forget()
        self.main_frame.grid(row=0, column=1, rowspan=4, columnspan=4, sticky="nsew")
        self.change_analysis(name)

2. 修复加载动画，用实例变量替代全局变量 #

把全局的countx改成实例变量，让动画逻辑依赖Tkinter的after()机制，确保在主线程处理：

def __init__(self):
    # 其他初始化代码...
    self.countx = 0  # 替换全局countx为实例变量
    self.cur_img = None  # 保留图片引用，防止被GC回收

def loading(self):      
    if self.t.is_alive():  
        print('EXECUTE LOAD')       
        self.main_frame.grid_forget()
        self.loading_frame.grid(row=0, column=1, rowspan=4, columnspan=4, sticky="nsew")
        self.loading_frame.grid_propagate(False)
        self.loading_lbl.pack_propagate(False)          
        extract_image_from_gif()
        self.play_gif() 

def play_gif(self):
    try:
        self.countx += 2
        cur_img = customtkinter.CTkImage(lst_image[self.countx], size=(800,200))
        self.loading_lbl.configure(image=cur_img)
        self.cur_img = cur_img  # 保留引用
        if self.t.is_alive():
            self.after(gif_duration, self.play_gif)
        else:
            return
    except IndexError:  # 捕获列表越界，更精准
        if self.t.is_alive():
            self.countx = 0
            self.after(gif_duration, self.play_gif)
        else:
            return

3. 确保热力图在主线程生成并嵌入界面 #

把plt.show()改成将Matplotlib图表嵌入到CustomTkinter的框架中，避免弹出独立窗口，同时确保所有操作在主线程执行：

def generate_heatmap(self):
    print('Generate HeatMap')
    brightness = []
    motion = []

    for k in figs_b.keys():
        l = figs_b[k][1]
        brightness.append(sum(l)/len(l))

    for s in figs_m.keys():
        print(s)    
        l = figs_m[s][1]
        motion.append(max(l))

    data = pd.read_csv(filedialog.askopenfilename())
    print(data)
    data.insert(2,'Color', avg_c)
    data.insert(3,'Motion', motion)
    data.insert(4,'Brightness', brightness)      

    # 明确指定Matplotlib使用Tk后端，和CustomTkinter兼容
    import matplotlib
    matplotlib.use('TkAgg')
    from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
    import matplotlib.pyplot as plt
    import seaborn as sns

    # 创建图表对象
    fig, ax = plt.subplots(figsize=(8, 6))
    sns.heatmap(data.corr(), annot=True, cmap='viridis', vmin=-1, vmax=1, ax=ax)

    # 清除主框架中之前的图表（如果有）
    for widget in self.main_frame.winfo_children():
        if hasattr(widget, 'get_tk_widget'):
            widget.get_tk_widget().destroy()

    # 将图表嵌入到CustomTkinter的主框架中
    canvas = FigureCanvasTkAgg(fig, master=self.main_frame)
    canvas.draw()
    canvas.get_tk_widget().pack(fill='both', expand=True)

4. 修复getGraph()中的语法错误 #

最后一行少了个闭合括号，改成：

avg_c.append(rgbtoint32([avg_r, avg_g, avg_b]))

另外建议把全局的avg_c改成实例变量self.avg_c，避免全局变量带来的意外问题。

这些修改后，你的多线程加载动画能正常运行，同时热力图的生成和显示都在主线程执行，不会再触发main thread is not in main loop的错误。

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