Qt 6.6.1线程阻塞后TaskCompleted槽无法触发问题排查

核心错误原因 #

你遇到的问题本质是线程阻塞导致事件循环无法处理槽调用：

• 使用Qt::QueuedConnection连接信号槽时，Qt会将槽函数的调用请求放入接收者（即你的MyThread实例）所在线程的事件队列，等待线程的事件循环处理。
• 但你的MyThread线程正被QWaitCondition::wait持续阻塞，线程完全没有机会运行事件循环，自然无法取出队列中的槽调用请求，导致TaskCompleted永远不会被执行。

具体问题拆解 #

1. 阻塞方式破坏事件循环：代码在while循环里反复调用condition.wait，完全占据了线程的执行时间，事件循环（如果存在）根本得不到运行机会。
2. QThread子类化的常见误用：Qt官方并不推荐直接子类化QThread并在run中做阻塞操作，更合理的方式是将业务逻辑封装到QObject子类，再通过moveToThread将对象移到线程中，让线程本身运行事件循环。

可行解决方案 #

方案1：修改连接类型（快速解决，需注意线程安全）

将连接类型改为Qt::DirectConnection，这样槽函数会直接在发送信号的线程（thread2）中执行，无需等待MyThread的事件循环：

connect(thread2, SIGNAL(tasksCompleted()), this, SLOT(TaskCompleted()), Qt::DirectConnection);

注意：此时TaskCompleted中的操作必须保证线程安全，比如访问shouldContinue、mutex等成员时要加锁保护。

方案2：改用事件循环控制线程（推荐）

放弃用QWaitCondition阻塞线程的方式，让MyThread的run函数启动事件循环，通过槽函数来终止线程：

void MyThread::run() {
    shouldContinue = true;
    emit signalForAnotherThread();
    exec(); // 启动线程的事件循环，线程会在这里等待事件
}

void MyThread::TaskCompleted() {
    shouldContinue = false;
    quit(); // 退出事件循环，run函数执行完毕，线程结束
}

这种方式符合Qt的线程设计规范，事件循环会自动处理所有队列中的信号槽调用，不会出现槽函数被阻塞的问题。

方案3：优化阻塞逻辑（不推荐，仅作参考）

如果必须保留QWaitCondition的阻塞逻辑，可以在每次wait唤醒后短暂处理事件，但这种方式代码复杂且容易出问题：

while (shouldContinue) {
    mutex.lock();
    // 设置超时，避免永久阻塞
    if (!condition.wait(&mutex, 100)) {
        // 处理事件队列中的请求
        QCoreApplication::processEvents(QEventLoop::AllEvents, 50);
    }
    mutex.unlock();
}

额外注意事项 #

• 确保shouldContinue是原子变量（比如用std::atomic<bool>），或者在访问它时始终持有mutex，避免多线程下的竞态条件。
• 检查MyThread是否已经通过start()方法正确启动，未启动的线程不会运行任何代码。

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