PyQt5 GUI多次运行线程后变白变灰功能正常问题求助

问题现象 #

• 程序启动后运行正常，多次点击按钮触发线程函数后，GUI逐渐变为全白或灰色
• 功能不受影响，复现无固定规律：可能点击几次就出现，也可能50-100次后触发，但最终必然复现
• 已尝试调整代码，问题仍未解决

核心执行流程 #

1. 信号绑定：按钮点击信号关联到start_stop_sb_thread函数，传入按钮对象

   self.obj.Config_Etc_mechanical.clicked.connect(lambda:self.Functions.start_stop_sb_thread(self.obj.Config_Etc_mechanical))
   

2. 线程启动入口：start_stop_sb_thread调用线程控制类的start_stop_test_thread，传入目标函数run_automation
3. 线程控制逻辑：start_stop_test_thread负责启动/停止线程，通过信号更新UI文本
4. 线程执行载体：CreateThread类管理Worker和QThread，在子线程中运行目标函数
5. 业务逻辑执行：run_automation调用具体的自动化测试函数，包含串口更新、耗时操作等

排查思路 #

1. 信号重复连接检查：每次调用start_stop_test_thread时，是否重复绑定ext_finished_signal到UI更新槽，导致信号堆积
2. 线程终止安全性检查：是否使用thread.terminate()强制终止线程，引发资源泄漏
3. 内存泄漏检查：每次点击后，Worker、Thread对象是否被正确回收，是否存在内存持续增长
4. UI操作线程安全检查：子线程中是否存在直接操作UI的代码，违反PyQt线程规则
5. 事件循环阻塞检查：主线程是否被长时间操作占用，导致UI无法刷新

解决方案 #

1. 修复信号重复连接问题 #

每次调用start_stop_test_thread时，重复连接ext_finished_signal会导致大量信号槽堆积，引发UI线程负载过高。

• 方案一：使用Qt.UniqueConnection标志避免重复连接

  if bt_to_change:
      self.test_worker.ext_finished_signal.connect(
          lambda: self.emit_ui_label(bt_to_change, stop_txt),
          Qt.UniqueConnection
      )
  

• 方案二：将信号连接移到初始化逻辑中，仅绑定一次

2. 替换不安全的线程终止方式 #

thread.terminate()会强制终止线程，导致资源未正常释放，包括UI相关资源。改用标志位让线程自行退出：

• 在Worker类中添加终止标志：

  class Worker(QObject):
      # ... 原有信号定义
      def __init__(self):
          super().__init__()
          self.stop_flag = False
  
      def stop(self):
          self.stop_flag = True
  
      @pyqtSlot()
      def run(self, func):
          try:
              self.my_started.emit()
              time.sleep(0.1)
              # 若业务函数支持中断，需在func内部定期检查stop_flag
              x = func()
              if not self.stop_flag:
                  self.my_success.emit()
                  self.my_finished.emit()
          # ... 原有异常处理逻辑
          finally:
              if self.stop_flag:
                  self.my_finished.emit()
  

• 修改kill_thread方法：

  def kill_thread(self):
      if self.running:
          self.worker.stop()
          self.thread.quit()
          self.thread.wait()
          self.running = False
      print('\nFunction stopped ! ')
  

3. 确保线程对象被正确回收 #

避免循环引用导致Worker、Thread无法被GC回收：

• 在finished_signal_connection中清除对象引用：

  @pyqtSlot()
  def finished_signal_connection(self):
      self.stop_flag = False
      self.running = False
      self.ext_finished_signal.emit()
      # 清除对Worker和Thread的引用
      self.worker = None
      self.thread = None
      print("\nFinished")
  

• 检查信号连接是否存在循环引用，例如Worker的信号不要连接到持有自身引用的对象槽

4. 保证UI操作的线程安全性 #

PyQt要求所有UI操作必须在主线程执行，子线程不能直接操作UI：

• 检查update_com_ports、cbs_to_funcs中的函数，若存在UI操作，改为通过信号发送到主线程处理：

  # 在主线程类中定义信号
  update_com_ui_signal = pyqtSignal(list)
  
  def __init__(self):
      # 绑定信号到主线程槽函数
      self.update_com_ui_signal.connect(self._update_com_ports_ui)
  
  def _update_com_ports_ui(self, ports):
      # 此处执行UI更新（如下拉框选项更新）
      pass
  
  def update_com_ports(self):
      # 子线程中仅获取数据，发送信号让主线程更新UI
      ports = self.get_available_com_ports()
      self.update_com_ui_signal.emit(ports)
  

5. 优化主线程事件循环 #

确保主线程不被长时间操作阻塞，保证UI刷新：

• 所有耗时操作必须放在子线程执行
• 若主线程存在短时间阻塞，可定期调用QApplication.processEvents()临时刷新UI（仅作为临时方案，优先优化子线程逻辑）

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