Thread.holdsLock() 是用于安全、轻量检测当前线程是否持有指定对象内置锁的静态方法，仅查询状态、不阻塞不加锁，适用于调试、断言及条件同步，但对 ReentrantLock 等显式锁无效。
Thread.holdsLock() 是 Java 中一个静态工具方法，用于在运行时**安全、轻量地检测当前线程是否已持有指定对象的内置锁（即监视器）**。它不阻塞、不尝试加锁、也不抛出异常，只做状态查询，适合用于调试、断言或条件性同步逻辑中。
方法签名与基本用法
该方法定义为：
public static boolean holdsLock(Object obj)参数 obj 必须是非 null 的对象实例（不能是 Class 对象或 null），返回值为 boolean：若当前线程正持有该对象的 monitor，则返回 true；否则返回 false。
注意：它只检查 synchronized(obj) { ... } 形式的内置锁，对 ReentrantLock 等显式锁无效。
立即学习“Java免费学习笔记（深入）”；
典型使用场景
- 调试与日志增强：在关键同步块内记录锁持有状态，辅助排查死锁或非预期的并发路径
- 防御性编程：在可重入方法中确认调用上下文是否已加锁，避免重复加锁或误操作
- 单元测试断言：验证同步逻辑是否按预期触发，例如测试某个方法是否必须在持锁状态下被调用
代码示例：验证锁持有关系
以下是一个清晰展示其行为的小例子：
public class LockCheckDemo {private final Object lock = new Object();
public void outer() {
synchronized (lock) {
System.out.println("outer: holdsLock(lock) = " + Thread.holdsLock(lock)); // true
inner();
}
}
public void inner() {
System.out.println("inner: holdsLock(lock) = " + Thread.holdsLock(lock)); // true
// 即使未在此处写 synchronized，只要外层已持锁，此处仍为 true
}
public void unguarded() {
System.out.println("unguarded: holdsLock(lock) = " + Thread.holdsLock(lock)); // false
}
}
注意事项与常见误区
- 不能替代同步机制：它只是“读状态”，不是“获取锁”。即使 holdsLock 返回 false，也不能直接调用它来加锁
-
不适用于 Class 锁：传入
MyClass.class是合法的，但需确保当前线程确实持有了该 Class 对象的锁（即在synchronized(MyClass.class)块内） -
与 wait/notify 无直接关联：调用
wait()会释放锁，之后holdsLock()将返回 false；而notify()不影响锁持有状态 - 性能开销极小：JVM 内部直接查线程栈和对象头信息，可放心用于开发/测试环境，但生产高频日志中建议控制使用频率
