关于Qt 5.13.2中QMutex::tryLock()同线程多次调用的合法性问询

两个版本文档的核心差异 #

• Qt 5.15 文档表述：

  递归模式的QMutex允许同一线程多次调用tryLock(int timeout)，每次调用都会成功并递增锁计数；非递归模式下，同一线程递归调用该方法会直接返回false，不会阻塞。

• Qt 6.4.1 文档表述：

  无论互斥量是否为递归类型，同一线程多次调用tryLock(int timeout)都会引发死锁——非递归互斥量会直接陷入死锁（线程已持有锁，再次尝试获取会永久阻塞）；递归互斥量若调用次数超过锁计数上限，也会触发死锁。

Qt 5.13.2 的实际行为 #

在Qt 5.x全系列（包括5.13.2）中，tryLock(int timeout)的行为和Qt 5.15文档描述完全一致：

• 递归互斥量：同一线程可以多次调用，每次调用都会成功获取锁，锁计数同步增加，后续需要对应次数的unlock()来释放。
• 非递归互斥量：同一线程在已持有锁的情况下调用tryLock(int timeout)，会立即返回false，不会进入阻塞逻辑，更不会触发死锁。

这是因为Qt 5.x对非递归QMutex的tryLock实现做了前置检查：如果当前线程已经持有该锁，直接返回失败，跳过后续的阻塞等待逻辑。而Qt 6.x调整了文档表述（同时优化了底层实现），将非递归锁的重入尝试明确为死锁场景——这里的“死锁”实际指线程自身阻塞（Qt 6中非递归锁的tryLock带超时调用会进入等待逻辑，直到超时才返回），但这和Qt 5.x的行为完全不同。

关于Qt 5.15文档的准确性 #

Qt 5.15的文档描述是准确的，完全符合Qt 5.x系列的实际运行逻辑。Qt 6.x的文档变更属于版本迭代后的表述规范，并非Qt 5.x文档存在错误。

对你的Qt 5.13.2的建议 #

同线程多次调用tryLock(int timeout)的合法性分两种情况：

• 使用递归互斥量：完全合法，按照递归锁的规则管理锁计数即可。
• 使用非递归互斥量：调用本身合法，但会直接返回false，不会引发死锁或崩溃，你可以根据返回值做后续逻辑处理。

内容的提问来源于stack exchange，提问作者黃君儒