Python 3.12新安装后绘图随机抛出PyCapsule_New空指针错误求助

我有一套在Python 3.7+Windows 10环境下运行完全正常的代码，用于生成各类图表与拟合曲线。但在新笔记本的Python 3.12全新环境中，代码虽能运行，却会随机在绘图初始化时抛出ValueError: PyCapsule_New called with null pointer错误，报错定位到初始化图表的代码行：

plt.figure(figsize=(figx,figy)) #generate clean figure

这个问题没有明显触发规律：调整绘图顺序、修改高斯拟合初始猜测值等微小改动后，有时又能正常运行。推测问题与matplotlib、Python版本或新环境安装相关，求解决建议。

完整报错信息：

File "D:\astra\ASTRA MS\Massify.py", line 435, in <module>
    ASTRA_MS.plot_set(x_m,t,y_ms,y_blur,y_superblur,y_megablur,figtext,titletext,shotnum,plotstyle=plotstyle,savepath=path,falling=falling,vlines=vlines,vacc=vacc,xlim=xlim,showplots=showplots,invertplot=invertplot,metadata=str(values))
  File "D:\astra\ASTRA MS\ASTRA_MS.py", line 259, in plot_set
    plt.figure(figsize=(figx,figy)) #generate clean figure
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\pyplot.py", line 1022, in figure
    manager = new_figure_manager(
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\pyplot.py", line 545, in new_figure_manager
    return _get_backend_mod().new_figure_manager(*args, **kwargs)
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\backend_bases.py", line 3521, in new_figure_manager
    return cls.new_figure_manager_given_figure(num, fig)
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\backend_bases.py", line 3526, in new_figure_manager_given_figure
    return cls.FigureCanvas.new_manager(figure, num)
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\backend_bases.py", line 1811, in new_manager
    return cls.manager_class.create_with_canvas(cls, figure, num)
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\backends\_backend_tk.py", line 479, in create_with_canvas
    with _restore_foreground_window_at_end():
  File "C:\Program Files\Python312\Lib\contextlib.py", line 137, in __enter__
    return next(self.gen)
  File "C:\Users\zachu\AppData\Roaming\Python\Python312\site-packages\matplotlib\backends\_backend_tk.py", line 43, in _restore_foreground_window_at_end
    foreground = _c_internal_utils.Win32_GetForegroundWindow()
ValueError: PyCapsule_New called with null pointer

解决建议 #

• 切换Matplotlib后端：报错来自Tk后端的窗口管理逻辑，尝试切换到其他后端，比如QtAgg或Agg：
  在代码开头添加：

  import matplotlib
  matplotlib.use('QtAgg') # 或者 'Agg'（无GUI，仅支持保存图表）
  

  若使用Agg后端，需确保代码用plt.savefig()保存图表，而非plt.show()。

• 降级Python或Matplotlib版本：Python 3.12是较新版本，可能与Matplotlib存在兼容性问题。可尝试降级到Python 3.11，或把Matplotlib降级到稳定兼容版本：

  pip install matplotlib==3.7.5
  

• 修复Matplotlib安装：新环境中Matplotlib的C扩展可能安装不完整，尝试重新安装：

  pip uninstall matplotlib -y
  pip install matplotlib --no-cache-dir
  

• 避免多线程/多进程绘图冲突：如果代码涉及多线程/多进程生成图表，Matplotlib的Tk后端在多线程环境下易出现随机错误，建议将绘图逻辑放在主线程执行，或使用支持多线程的后端。

• 临时禁用窗口前景恢复逻辑：应急情况下可修改Matplotlib源码，找到matplotlib/backends/_backend_tk.py文件，注释掉with _restore_foreground_window_at_end():这一行及其缩进代码（不推荐长期使用，仅作临时修复）。

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