频繁调用matplotlib flush_events()导致PySide6 GUI崩溃的原因？

问题背景 #

• 环境版本：Python 3.13、matplotlib 3.10.0、PySide6 6.8.2.1、Windows 11 Home 23H2
• 实现逻辑：基于matplotlib官方示例的BlitManager类，实现两个画布的blitting交互更新；将mouse_moved_in_canvas方法绑定到第一个画布的motion_notify_event事件
• 崩溃现象：快速晃动鼠标触发大量事件时，程序出现栈溢出错误，退出码为-1073741571（对应Windows错误码0xC00000FD）
• 临时验证：注释掉BlitManager.update方法中的cv.flush_events()调用后，崩溃消失，且未发现明显性能影响

问题1：频繁调用flush_events()为何会导致GUI崩溃？ #

• flush_events()的核心作用是强制清空matplotlib的内部事件队列，同时会触发GUI后端（这里是Qt）的事件处理
• 在PySide6的Qt事件循环中，每次鼠标移动触发motion_notify_event时，同步调用flush_events()会引发事件递归处理：Qt的当前事件还未处理完毕，又被强制触发新一轮的事件调度，短时间内大量触发会导致调用栈不断叠加，最终超出系统允许的栈容量，触发栈溢出错误
• 本质是matplotlib的事件机制与Qt的主事件循环产生冲突，频繁的flush_events()打破了Qt事件循环的正常调度逻辑，造成栈帧堆积

问题2：是否可以安全移除该调用，或有其他替代方案？ #

方案1：直接移除flush_events()（优先推荐） #

• 在PySide6的Qt后端下，matplotlib的事件会自动集成到Qt的主事件循环中，无需手动调用flush_events()来强制刷新界面
• 从测试结果来看，移除后既解决了崩溃问题，又未影响性能，说明当前场景下Qt的事件调度完全能满足blitting的更新需求，移除是安全的
• 后续如果出现事件延迟、界面更新不及时的情况，再考虑其他方案

方案2：限制事件触发频率 #

• 若担心移除flush_events()有潜在风险，可以给鼠标移动事件添加节流逻辑，限制短时间内的事件触发次数，避免大量事件堆积
• 示例代码：

import time

_last_update_ts = 0
def mouse_moved_in_canvas(event):
    global _last_update_ts
    now = time.time()
    # 设置50ms的触发间隔，避免高频调用
    if now - _last_update_ts < 0.05:
        return
    _last_update_ts = now
    # 执行原有的blitting更新逻辑
    blit_manager.update()

方案3：异步调用flush_events() #

• 把flush_events()放到Qt的异步队列中执行，避免在事件回调中同步调用导致栈溢出
• 示例代码：

from PySide6.QtCore import QTimer

def _safe_flush_events(cv):
    cv.flush_events()

# 在BlitManager.update方法中替换原有的cv.flush_events()调用
QTimer.singleShot(0, lambda: _safe_flush_events(cv))

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