ReentrantLock.getQueuedThreads()返回当前在AQS同步队列中等待获取锁的线程集合，是尽力而为的快照，非实时、非线程安全，不包含已持锁、tryLock失败或已退出等待的线程。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

<p><strong>ReentrantLock.getQueuedThreads()</strong> 返回的是当前正在等待获取该锁的线程集合（不包括已持有锁的线程），但要注意：这个集合是<strong>尽力而为的快照</strong>，不是实时、精确、线程安全的视图。</p>

<H3>返回值含义与使用场景</H3>
<p>该方法返回一个 <code>Collection<Thread></code>，包含所有已调用 <code>lock()</code> 但尚未获得锁、正处于 AQS 同步队列中等待的线程。它不包含：</p>
<ul>
  <li>已成功获取锁、正在执行临界区代码的线程；</li>
  <li>调用 <code>tryLock()</code> 失败后直接返回、未进入队列的线程；</li>
  <li>因超时或被中断而退出等待、但尚未从队列中移除的残留节点（极短暂）。</li>
</ul>

<H3>调用时机与注意事项</H3>
<p>必须在持有锁期间或确保锁状态稳定的上下文中调用，否则结果可能过期或不一致：</p>
<ul>
  <li>若在无锁状态下直接调用，可能看到空集合，即使下一毫秒就有线程开始排队；</li>
  <li>若在锁被频繁争抢的高并发场景下，返回的集合可能刚生成就已过时；</li>
  <li>返回的集合是不可修改的（unmodifiable），遍历时若线程状态变化，不会抛异常，但内容可能不反映最新状态。</li>
</ul>

<H3>典型用法示例</H3>
<p>常用于监控、调试或诊断锁竞争问题：</p>
<ul>
  <li>打印当前排队线程名：<code>lock.getQueuedThreads().forEach(t -> System.out.println(t.getName()));</code></li>
  <li>统计排队数量：<code>int waiting = lock.getQueuedThreads().size();</code></li>
  <li>结合 <code>isLocked()</code> 和 <code>getHoldCount()</code> 判断是否发生严重竞争。</li>
</ul>

<H3>替代方案与补充信息</H3>
<p>如需更精确的锁状态分析，可配合其他方法：</p>
<ul>
  <li><code>getQueueLength()</code>：返回估算的排队线程数（轻量，推荐用于性能敏感场景）；</li>
  <li><code>hasQueuedThreads()</code>：快速判断是否有线程在排队；</li>
  <li><code>getOwner()</code>：获取当前持有锁的线程（仅适用于非公平锁且锁已被占用时）；</li>
  <li>JDK 自带的 <code>java.util.concurrent.locks.LockSupport</code> 或 JMX（如 <code>ThreadMXBean</code>）可辅助定位阻塞点。</li>
</ul>