当主线程显然未阻塞时，QProgressDialog 冻结

Posted 2023-02-17

【中文标题】当主线程显然未阻塞时，QProgressDialog 冻结

【英文标题】：QProgressDialog freezes when the main thread is apparently non blocked

【发布时间】：2020-07-21 15:16:54

【问题描述】：

我正在处理一个在耗时的计算过程中使用QProgressDialog 的项目。为了不阻塞主 UI 线程，执行计算的类被移动到一个新的QThread，并使用使用Qt::AutoConnection 连接的开始和结束信号与主线程同步，@987654324 的默​​认选项@。我的问题是QProgressDialog 有时会冻结，这可以在this 视频中看到（还附了一个gif 版本，但不如视频那么清晰）：

在此动画中，您可以看到启动项目后，进度条如何卡在Second check。并且应用程序保持这种状态，直到鼠标再次进入QProgressDialog。这种情况最终会发生，如果您将鼠标移到其他窗口上，则更容易发生这种情况。而且它永远不会在同一阶段发生。

软件的主要部分包含一个StateMachine，它位于主线程中并继承QObject并与其余小部件（在本例中为QProgressDialog）交互：

state_machine.h

#pragma once
#include <QObject>

class StateMachine : public QObject

  Q_OBJECT
public:
  static StateMachine* open(QThread* worker_thread, QWidget* parent);

signals:

  void finished();
  void datasetOpened();
  void requestCloseDataset();
  void errorMessage(QString text);

  void progressShow();

  void progressHide();

  void progressText(QString text);

  void requestProcess1();
  void requestProcess2();
  void requestProcess3();
  void requestProcess4();
protected slots:

  void process1Done();

  void process2Done();

  void process3Done();

  void process4Done();

protected:
  StateMachine(QThread* worker_thread, QWidget* parent = nullptr);
;

state_machine.cpp

#include "state_machine.h"

#include <QWidget>

#include "progress_dialog.h"
#include "state_machine_worker.h"

StateMachine *StateMachine::open(QThread *worker_thread, QWidget *parent)

  return new StateMachine(worker_thread, parent);


StateMachine::StateMachine(QThread *worker_thread, QWidget *parent) : QObject(parent)

  // Connect
  connect(this, &StateMachine::finished, this, &QObject::deleteLater);

  // Create worker
  StateMachineWorker *worker = new StateMachineWorker();
  worker->moveToThread(worker_thread);
  connect(this, &StateMachine::finished, worker, &QObject::deleteLater);
  /// Dataset file license
  connect(this, &StateMachine::requestProcess1, worker, &StateMachineWorker::process1);
  connect(worker, &StateMachineWorker::process1Done, this, &StateMachine::process1Done);
  /// Sonar list
  connect(this, &StateMachine::requestProcess2, worker, &StateMachineWorker::process2);
  connect(worker, &StateMachineWorker::process2Done, this, &StateMachine::process2Done);
  /// Sonar limit
  connect(this, &StateMachine::requestProcess3, worker, &StateMachineWorker::process3);
  connect(worker, &StateMachineWorker::process3Done, this, &StateMachine::process3Done);
  /// Dataset initialize
  connect(this, &StateMachine::requestProcess4, worker, &StateMachineWorker::process4);
  connect(worker, &StateMachineWorker::process4Done, this, &StateMachine::process4Done);

  // Create progress
  ProgressDialog *progress = ProgressDialog::create("OpenProject", "", "", 0, 0, parent, Qt::ApplicationModal);
  connect(this, &StateMachine::progressHide, progress, &QWidget::hide);
  connect(this, &StateMachine::progressShow, progress, &QWidget::show);
  connect(this, &StateMachine::finished, progress, &QWidget::hide);
  connect(this, &StateMachine::progressText, progress, &ProgressDialog::setLabelText);
  connect(this, &StateMachine::finished, progress, &QObject::deleteLater);

  // Check dataset file license
  emit progressText("First check");
  emit progressShow();
  emit requestProcess1();


void StateMachine::process1Done()

  emit progressText("Second check");
  emit requestProcess2();


void StateMachine::process2Done()

  emit progressText("Third check");
  emit requestProcess3();


void StateMachine::process3Done()

  emit progressText("Fourth check");
  emit requestProcess4();


void StateMachine::process4Done()

  emit progressHide();
  emit requestCloseDataset();
  emit datasetOpened();
  emit finished();

一个StateMachineWorker，它存在于辅助线程中并与StateMachine 交互并执行线程阻塞的进程。

state_machine_worker.h

#pragma once
#include <QObject>

class StateMachineWorker : public QObject

  Q_OBJECT
public:
  StateMachineWorker(QObject* parent = nullptr);

signals:

  void process1Done();

  void process2Done();

  void process3Done();

  void process4Done();

public slots:
  void process1();

  void process2();

  void process3();

  void process4();
;

state_machine_worker.cpp

#include "state_machine_worker.h"

#include <thread>

StateMachineWorker::StateMachineWorker(QObject *parent) : QObject(parent)



void StateMachineWorker::process1()

  std::this_thread::sleep_for(std::chrono::seconds(2));
  emit process1Done();


void StateMachineWorker::process2()

  std::this_thread::sleep_for(std::chrono::seconds(2));
  emit process2Done();


void StateMachineWorker::process3()

  std::this_thread::sleep_for(std::chrono::seconds(2));
  emit process3Done();


void StateMachineWorker::process4()

  std::this_thread::sleep_for(std::chrono::seconds(2));
  emit process4Done();

可以在here 找到整个示例。如您所见，worker 被移动到线程以避免阻塞主 UI 线程。但是，正如在上一个视频中看到的那样，无论主线程是否被阻塞（或者至少我认为它没有被阻塞），GUI 都会变得无响应。

你知道我做错了什么吗？如何使进度对话框不冻结？如果我将QProgressDialog 设置为Qt::NonModal 而不是Qt::ApplicationModal，问题就会消失，但我想阻止其他小部件的输入，因此无法更改。

这只发生在 Windows 上，并且已经在 Windows 10、MSVC 19.26.28806.0 和 Qt 版本 5.14.2 上进行了测试。在带有 g++7 和 Qt 5.9.5 的 Ubuntu 中不会发生。

PS：我知道StateMachine 和StateMacineWorker 因为它可能只是一个存在于辅助线程中并通过信号/插槽直接与主线程小部件交互的对象，而不是让StateMachine 存在于主线程并与worker交互，但这不是这个问题的主要关注点。

【参考方案1】：

问题显然是 Qt 中的一些错误。在 Windows 中使用 Qt 5.15.0，问题就消失了。