Dash/Flask调用Matplotlib绘图超时与非主线程GUI警告问题求解

问题根因说明 #

你设置的threaded=False未生效是因为启动参数里开了debug=True，Flask的Debug模式默认会启动独立线程运行的自动重载器，就算配置了单线程参数依然会存在多线程场景，触发Matplotlib的GUI线程警告。

可用解决方案 #

• 方案1：关闭Debug模式或禁用重载器
  直接关闭debug，或者保留debug的同时新增use_reloader=False参数，即可保证threaded=False配置生效，让Flask完全单线程运行，启动代码修改为：

  if __name__ == "__main__":
      app.run_server(debug=True, threaded=False, use_reloader=False)
  

• 方案2：切换Matplotlib为无GUI后端
  如果你只是生成保存图表不需要弹出GUI窗口，在导入matplotlib.pyplot之前设置非交互式后端，就能完全避免GUI相关的线程冲突，这是最通用的轻量解决方案：

  import matplotlib
  matplotlib.use('Agg') # 该行必须放在import pyplot之前执行
  import matplotlib.pyplot as plt
  

• 方案3：加线程锁保证Matplotlib调用串行
  如果你需要保留Flask多线程运行提升响应性能，可以通过线程锁把Matplotlib的绘图逻辑包裹起来，保证同一时间只有一个线程操作Matplotlib接口，示例实现：

  import threading
  # 全局声明Matplotlib专用锁
  mpl_lock = threading.Lock()
  
  def draw_figure():
      # 所有绘图、保存逻辑都放在锁上下文内
      with mpl_lock:
          fig, ax = plt.subplots(1, 1)
          # 剩余绘图、保存逻辑
  

• 方案4：完全弃用pyplot全局接口，纯OOP调用
  不使用plt开头的全局方法，所有画布、轴对象都手动创建销毁，避免全局状态的线程冲突，这是Matplotlib官方推荐的多线程场景用法。

内容的提问来源于stack exchange，提问作者j. DOE