pytest测试GUI按钮调用plt.show()失败：断言未触发问题排查

1. Mock 位置与导入路径不匹配 #

如果你的GUI代码里是直接导入pyplot的子属性（比如from matplotlib.pyplot import show），而测试里mock的是matplotlib.pyplot.show，就会出现mock没生效的情况——此时GUI代码引用的是导入时的原始show方法，而非mock后的对象。

解决方式：

• 确保测试中mock的路径和GUI代码实际使用的导入路径完全一致。比如GUI里用import matplotlib.pyplot as plt，测试就mockmatplotlib.pyplot.show；如果GUI里用from matplotlib import pyplot as plt，同样对应这个路径。
• 示例测试代码：

from unittest.mock import patch
from your_gui_module import YourGUI

def test_plot_button():
    with patch('your_gui_module.plt.show') as mock_show:
        gui = YourGUI()
        gui.plot_button.invoke()  # 触发按钮点击
        mock_show.assert_called_once()

2. GUI 事件循环未处理 #

很多GUI框架（Tkinter、PyQt等）的按钮点击是异步触发的，测试中点击按钮后直接断言，事件循环还没来得及执行回调里的绘图逻辑，导致show还没被调用。

解决方式：

• Tkinter场景：调用root.update()或root.update_idletasks()处理待执行事件：

import tkinter as tk
from unittest.mock import patch
from your_gui_module import YourGUI

def test_tkinter_plot_button():
    with patch('matplotlib.pyplot.show') as mock_show:
        root = tk.Tk()
        gui = YourGUI(root)
        gui.plot_button.invoke()
        root.update()  # 强制处理事件循环
        mock_show.assert_called_once()

• PyQt场景：使用QApplication.processEvents()：

from PyQt5.QtWidgets import QApplication
from unittest.mock import patch
from your_gui_module import YourGUI

def test_pyqt_plot_button():
    app = QApplication([])
    with patch('matplotlib.pyplot.show') as mock_show:
        gui = YourGUI()
        gui.plot_button.click()
        QApplication.processEvents()  # 处理pending事件
        mock_show.assert_called_once()

3. 绘图逻辑存在分支判断 #

检查按钮回调函数里是否有条件判断（比如数据为空、参数不合法），导致代码没走到调用plt.show()的分支。比如：

def on_plot_click():
    if not has_valid_data():
        return
    plt.plot([1,2,3])
    plt.show()

如果测试中未初始化有效数据，就不会触发show调用。此时需要在测试前确保满足绘图的前置条件。

4. Mock 时机错误 #

如果测试代码先导入GUI模块，再进行mock，GUI模块已经加载了原始的plt.show方法，mock不会生效。必须在导入GUI模块之前完成mock。

错误示例：

from your_gui_module import YourGUI  # 先导入GUI，此时plt.show已被引用
from unittest.mock import patch

def test_wrong_order():
    with patch('matplotlib.pyplot.show') as mock_show:
        gui = YourGUI()
        gui.plot_button.invoke()
        mock_show.assert_called_once()  # 断言失败

正确做法：

from unittest.mock import patch

def test_correct_order():
    with patch('matplotlib.pyplot.show') as mock_show:
        from your_gui_module import YourGUI  # 在mock之后导入GUI
        gui = YourGUI()
        gui.plot_button.invoke()
        mock_show.assert_called_once()

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