Qt长时间运行后QLabel的QPixmap不再更新问题排查

• 跨线程UI调用非法：Qt规定所有UI更新操作必须在主线程执行，如果子线程直接调用showImage回调操作UI控件，会导致主线程事件队列紊乱、事件积压，长时间运行后队列完全堵塞，UI停止更新。
• 内存共享冲突：QImage(frame.data, ...)构造方式为浅拷贝，直接共享cv::Mat的底层缓冲区，子线程下一帧采集时会直接覆盖该缓冲区，轻则出现花屏，重则触发野指针、内存访问异常，导致后续渲染流程中断。
• 语法/逻辑bug：原代码存在多处笔误和不规范写法：
  • 子线程中m_videoCapture是指针类型，判断打开状态应该用m_videoCapture->isOpened()，原代码用.调用成员函数，判断逻辑异常时会直接退出采集循环，停止输出帧。
  • 缩放参数拼写错误：Qt::SmoothTransformat应为Qt::SmoothTransformation，copy后缺少()，会导致缩放、拷贝逻辑失效，甚至触发未知异常。
• 资源泄漏：GStreamer后端长时间运行可能出现缓冲区泄漏、管道堵塞，加上未做帧有效性校验，出现无效帧后没有容错逻辑，最终采集流程中断。
• 事件队列积压：如果相机采集帧率远高于主线程渲染帧率，大量未处理的更新事件会堆积在主线程事件队列，长时间运行后队列占满，新的更新事件无法被处理。

• 规范跨线程通信：用Qt信号槽机制传递帧数据，将子线程的采集信号通过Qt::QueuedConnection连接到主线程的展示槽函数，保证UI操作始终在主线程执行。
• 避免内存共享：构造QImage后执行深拷贝，完全脱离cv::Mat的内存管理，修改代码如下：

  showImage(cv::Mat& frame)
  {
      if (frame.empty()) return; // 增加空帧校验
      // 构造后调用copy()做深拷贝，不依赖cv::Mat的缓冲区
      QImage m_image = QImage(frame.data, frame.cols, frame.rows, frame.step, QImage::Format_RGB888).copy();
      QPixmap pixmap = QPixmap::fromImage(m_image);
      // 修正参数拼写和copy调用
      m_pixmap = pixmap.scaled(width, height, Qt::IgnoreAspectRatio, Qt::SmoothTransformation);
      ui->m_label->setPixmap(m_pixmap);
  }
  

• 修正采集逻辑错误：把子线程的循环判断条件改为while(m_videoCapture->isOpened())，保证采集循环正常运行；增加采集异常容错，连续多次读取帧失败时自动重启GStreamer管道、重连相机。
• 控制帧率避免队列积压：增加丢帧逻辑，若主线程上一帧还未处理完成，直接丢弃当前采集的新帧；或用定时器固定30ms/60ms刷新一次QLabel，不用每次采集到帧就触发更新。
• 定期巡检：增加帧更新心跳检测，若超过2秒没有新帧渲染，自动重启采集线程，无需重启整个应用。

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