Thread.holdsLock()用于检查当前线程是否持有指定对象的synchronized内置锁，仅在synchronized块内调用才有效，返回true表示持有该锁，不适用于ReentrantLock等显式锁，且不能用于同步控制。

Thread.holdsLock 是一个静态方法，用于检查**当前线程是否持有指定对象的监视器锁（即 synchronized 锁）**。它不适用于 ReentrantLock 等显式锁，只对 synchronized 关键字加的内置锁有效。

方法签名与基本用法

该方法声明为：

public static boolean holdsLock(Object obj)

参数 obj 是要检测锁的对象（不能为 null），返回 true 表示当前线程正持有该对象的 monitor lock。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

只能在 synchronized 块/方法内部安全使用

因为只有进入 synchronized 区域后，线程才可能持有锁；在外部调用 holdsLock 总是返回 false —— 即使锁被其他线程持有，当前线程也无法感知。

立即学习“Java免费学习笔记（深入）”；

• 必须在已获得锁的上下文中调用，否则结果无意义
• 不能用来“探测”其他线程是否持锁，仅反映当前线程自身状态
• 典型用途是调试、断言或条件性执行（例如避免重复加锁）

实际使用示例

以下代码演示了正确用法：

Object lock = new Object();

void doSomething() {
    synchronized (lock) {
        // 此时当前线程一定持有 lock 的锁
        assert Thread.holdsLock(lock); // true

        if (Thread.holdsLock(lock)) {
            System.out.println("当前线程持有 lock");
        }

        // 可用于防止递归重入时重复初始化等逻辑
        if (!someFlag && Thread.holdsLock(lock)) {
            someFlag = true;
            initialize();
        }
    }
}

常见误区提醒

• 不适用于 ReentrantLock：holdsLock 对 java.util.concurrent.locks.ReentrantLock 无效，因为它不基于 JVM monitor
• 不能替代 tryLock：它不尝试获取锁，也不提供超时或中断能力
• 非原子性也不保证可见性：只是快照式检查，结果瞬间可能变化，不可用于同步控制逻辑
• null 参数抛 NullPointerException：调用前需确保 obj 非 null