ReentrantLock 提供 getHoldCount() 方法获取当前线程持锁次数,返回该线程 lock() 与 unlock() 次数之差;仅对当前线程有效,未持锁时返回 0,不可跨线程查询。

ReentrantLock 本身不提供直接获取“当前线程持有锁次数”的公开 API,但可以通过其内部状态和 getHoldCount() 方法实现——该方法正是为此设计的。
使用 getHoldCount() 查询当前线程的持锁次数
ReentrantLock 继承自 AbstractQueuedSynchronizer(AQS),支持重入。它的 getHoldCount() 方法会**返回当前线程调用 lock() 的次数减去对应 unlock() 的次数**,即当前线程对该锁的“净持有计数”。
- 仅对当前线程有效:如果当前线程未持有该锁,返回 0;
- 必须在已获得锁的上下文中调用(否则结果仍为 0,但无实际意义);
- 是非静态、非同步的方法,调用时无需额外加锁。
正确调用示例
需确保在 lock() 之后、unlock() 之前调用:
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
ReentrantLock lock = new ReentrantLock();
lock.lock();
try {
System.out.println("Hold count: " + lock.getHoldCount()); // 输出 1
lock.lock(); // 再次加锁(重入)
System.out.println("Hold count: " + lock.getHoldCount()); // 输出 2
} finally {
lock.unlock(); // 释放一次
System.out.println("Hold count: " + lock.getHoldCount()); // 输出 1
lock.unlock(); // 完全释放
}
注意不可跨线程查询
getHoldCount() 只反映**调用线程自身**的持有状态:
- 其他线程调用它,即使锁被别的线程持有,也只会返回 0;
- 没有类似
getHoldCount(Thread t)的方法,无法查任意线程的持锁次数; - 如需监控全局锁状态,可考虑使用
hasQueuedThreads()、isLocked()或开启getOwner()辅助判断,但这些都不等价于“某线程持锁次数”。
调试与日志中的实用建议
在排查重入逻辑或死锁风险时,可在关键路径中记录持锁次数:
- 配合
Thread.currentThread().getName()打印上下文,避免混淆; - 避免在无锁状态下频繁调用(虽安全但无意义);
- 生产环境慎用大量日志,因
getHoldCount()是轻量操作,但日志 I/O 开销大。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










