Qt主线程带超时等待QtConcurrentRun线程完成任务的有效方案

你当前实现的核心阻塞问题源于QWaitCondition的底层逻辑：wait()方法在超时返回前，会尝试重新锁定你传入的互斥量。如果工作线程拿到互斥量后在执行第三方API时挂死、永远不释放锁，主线程就会卡在锁等待步骤，完全达不到超时退出的设计目标。
另外你的示例代码还存在两处隐性问题：

• 拼写错误：QtConcurrentRun::run应为QtConcurrent::run，isStared应为isStarted，MyClas应为MyClass
• 唤醒丢失风险：如果工作线程在主线程调用wait()前就执行完成并调用wakeAll()，这个唤醒信号会被丢弃，主线程只能等到超时才会退出，哪怕任务早就执行完毕。

你已经在用QtConcurrent::run，它返回的QFuture原生支持带超时的等待逻辑，完全不需要自己维护互斥量和等待条件，也不会出现锁等待阻塞的问题：

void MyClass::startBackgroundWork()
{
    // 启动异步任务
    QFuture<bool> myBackgroundTask = QtConcurrent::run(&MyClass::threadProc, this);
    // 等待最多200ms，超时直接返回false，不会被工作线程的挂死阻塞
    bool taskFinished = myBackgroundTask.waitForFinished(200);
    
    if(taskFinished)
    {
        // 任务执行完成，可通过result()获取线程返回值
        bool execResult = myBackgroundTask.result();
        // 成功逻辑
    }
    else
    {
        // 超时逻辑，注意此时工作线程可能仍在后台运行
        // 如果需要终止任务，建议改用QThread实现配合中断标志
    }
}

bool MyClass::threadProc()
{
    // 仅在访问类共享成员时加局部锁，不要全程持有锁
    // QMutexLocker lock(m_myMutex);
    /// 调用第三方API的逻辑放在这里
    return true;
}

如果你必须使用QWaitCondition实现，可以把工作线程的锁持有时间压缩到最短，仅在更新共享状态、发送唤醒信号时加锁，避免执行第三方API时持有锁：
首先需要在类中新增一个共享状态变量bool m_taskFinished，用于判断任务是否完成，避免唤醒丢失。

void MyClass::startBackgroundWork()
{
    QMutexLocker lock(m_myMutex);
    m_taskFinished = false;
    bool waitSuccess = false;
    
    QFuture<void> myBackgroundTask = QtConcurrent::run(&MyClass::threadProc, this);
    // 循环等待避免虚假唤醒
    while (!m_taskFinished) {
        if (!m_waitCondition.wait(&m_myMutex, 200)) {
            // 超时退出
            break;
        }
    }
    waitSuccess = m_taskFinished;
    
    if(waitSuccess)
    {
        /// 成功逻辑
    }
    else
    {
        /// 超时逻辑
    }
}

void MyClass::threadProc()
{
    /// 调用第三方API的逻辑完全不加锁，哪怕挂死也不会持有锁
    /// Do stuff here
    
    // 仅在更新状态、发唤醒信号时短暂加锁
    QMutexLocker locker(m_myMutex);
    m_taskFinished = true;
    m_waitCondition.wakeAll();
}

• QtConcurrent启动的任务默认不支持强制取消，如果超时后需要终止挂死的工作线程，推荐改用QThread实现，超时后调用requestInterruption()请求中断，极端场景下可使用terminate()强制结束（可能引发资源泄漏，谨慎使用）。
• 所有跨线程共享的变量访问必须加锁保护，禁止无锁直接读写。

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