寻找可判断WebLogic Server域是否处于锁定状态的API

刚好我之前在处理WebLogic部署自动化的时候遇到过完全一样的需求——为了避免并行部署冲突，必须先确认域没有被锁定才能执行部署操作。下面是两种可靠的程序化实现方式：

1. 使用WLST（WebLogic Scripting Tool）脚本 #

WLST是WebLogic自带的脚本工具，能很方便地调用域级管理MBean。你可以通过ConfigurationManagerMBean的isDomainLocked()方法直接获取状态：

# 连接到AdminServer
connect('你的管理员用户名', '管理员密码', 't3://admin-server-host:7001')

# 切换到DomainRuntime上下文，访问域级管理MBean
domainRuntime()

# 获取ConfigurationManager MBean实例
config_mgr = getMBean('ConfigurationManager')

# 调用方法判断锁定状态
is_locked = config_mgr.isDomainLocked()
print(f"当前Domain锁定状态: {'已锁定' if is_locked else '未锁定'}")

# 断开连接
disconnect()

2. 使用Java JMX API调用 #

如果你的部署工具是Java编写的，可以直接通过JMX连接到AdminServer，调用同样的MBean方法：

import javax.management.MBeanServerConnection;
import javax.management.ObjectName;
import javax.naming.Context;
import weblogic.management.mbeanservers.domainruntime.DomainRuntimeServiceMBean;
import weblogic.management.configuration.ConfigurationManagerMBean;
import java.util.Hashtable;

public class CheckDomainLockStatus {
    public static void main(String[] args) throws Exception {
        // 配置JMX连接参数
        Hashtable<String, String> env = new Hashtable<>();
        env.put(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory");
        env.put(Context.PROVIDER_URL, "t3://admin-server-host:7001");
        env.put(Context.SECURITY_PRINCIPAL, "你的管理员用户名");
        env.put(Context.SECURITY_CREDENTIALS, "管理员密码");

        // 获取MBeanServer连接
        Context ctx = new javax.naming.InitialContext(env);
        MBeanServerConnection conn = (MBeanServerConnection) ctx.lookup("java:comp/env/jmx/domainRuntime");

        // 获取DomainRuntimeServiceMBean
        ObjectName drsName = new ObjectName(DomainRuntimeServiceMBean.OBJECT_NAME);
        ObjectName configMgrName = (ObjectName) conn.getAttribute(drsName, "ConfigurationManager");

        // 调用isDomainLocked方法
        Boolean isLocked = (Boolean) conn.invoke(configMgrName, "isDomainLocked", new Object[]{}, new String[]{});
        System.out.println("Domain锁定状态: " + (isLocked ? "已锁定" : "未锁定"));

        ctx.close();
    }
}

关键说明 #

• ConfigurationManagerMBean是WebLogic专门用于管理域配置锁定的MBean，它的isDomainLocked()方法是官方提供的域级状态判断API，完全满足你防止并行部署的需求。
• 当域处于锁定状态时，所有需要修改配置的操作（包括应用部署、域配置变更）都会被阻塞，直到域被解锁或者锁定超时。
• 注意：调用这些API需要具备WebLogic的管理员权限，否则会抛出权限不足的异常。

内容的提问来源于stack exchange，提问作者Mayank Kumar