PyQt5多进程绘制音频信号时窗口关闭异常排查

你遇到的窗口关闭后程序无法正常退出的问题，核心原因大概率是多进程资源未彻底清理、Matplotlib绘图残留或PyQt关闭事件处理不完整，以下是具体问题点和解决办法：

常见错误点 #

1. 子进程未被正确终止/回收
   如果子进程中存在Matplotlib的交互式循环（比如plt.pause()或plt.show()），主窗口关闭时若未主动终止子进程，子进程会残留后台，导致主进程无法完全退出。

2. Matplotlib资源未释放
   多进程中绘图后未关闭Figure，或未指定正确的Qt后端，会导致Matplotlib的事件循环残留，阻止进程退出。

3. 关闭事件处理逻辑缺失
   重写closeEvent时，仅关闭了主窗口，但未清理多进程、定时器（若有）或Matplotlib资源。

具体修正方案 #

1. 用优雅的方式终止子进程（替代强制终止） #

使用multiprocessing.Event作为退出信号，让子进程主动清理资源后退出，避免强制终止带来的资源泄漏：

子进程绘图函数示例

def plot_audio(stop_event, audio_segment):
    # 子进程内单独初始化Matplotlib Qt后端
    import matplotlib
    matplotlib.use('Qt5Agg')
    import matplotlib.pyplot as plt
    import numpy as np

    # 转换音频数据
    samples = np.array(audio_segment.get_array_of_samples())
    sample_rate = audio_segment.frame_rate
    # 生成3秒时间轴，不足部分补0
    time_axis = np.linspace(0, 3, int(3 * sample_rate))
    plot_data = np.zeros_like(time_axis)
    plot_data[:len(samples)] = samples

    # 初始化绘图
    fig, ax = plt.subplots()
    ax.plot(time_axis, plot_data)
    ax.set_xlabel('Time (s)')
    ax.set_ylabel('Amplitude')
    plt.ion()  # 启用交互式模式

    # 循环检查退出信号
    while not stop_event.is_set():
        plt.pause(0.01)

    # 主动清理Matplotlib资源
    plt.close(fig)

2. 完善窗口关闭事件处理 #

在主窗口的closeEvent中，先触发子进程退出信号，等待子进程回收，再清理所有Matplotlib资源：

class AudioPlotWindow(QMainWindow):
    def __init__(self, audio_segment):
        super().__init__()
        # 初始化多进程退出信号
        self.stop_event = multiprocessing.Event()
        self.plot_process = multiprocessing.Process(
            target=plot_audio,
            args=(self.stop_event, audio_segment)
        )
        self.plot_process.start()

    def closeEvent(self, event):
        # 触发子进程退出信号
        self.stop_event.set()
        # 等待子进程结束，超时则强制终止
        if self.plot_process.is_alive():
            self.plot_process.join(timeout=2)
            if self.plot_process.is_alive():
                self.plot_process.terminate()
                self.plot_process.join()
        # 清理所有Matplotlib窗口
        plt.close('all')
        # 调用父类关闭逻辑
        super().closeEvent(event)

3. 其他注意事项 #

• 禁止跨进程操作PyQt控件：PyQt的UI对象不能在多进程间共享，子进程应独立完成绘图逻辑，或通过管道传递图像数据给主进程显示。
• 若使用QTimer更新绘图，关闭窗口前需调用timer.stop()终止定时器，避免残留事件循环。

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