WAS Liberty 25.x(Jakarta EE10)独立Java客户端JNDI初始化问题求解

核心背景说明 #

Liberty 25.x（Jakarta EE 10）中不再提供 WAS 9.x 的com.ibm.ws.ejb.thinclient_9.0.jar，替代方案是使用 Liberty 安装目录下的wlp/clients/wlp-clients.jar，该包包含远程 EJB 和 JNDI 所需的全部类。同时，初始上下文工厂类仍可使用com.ibm.websphere.naming.WsnInitialContextFactory，但需确保类路径和配置正确。

以下针对两种运行场景分别给出解决步骤：

1. Web UI 运行的批处理（部署在 Liberty 服务器内） #

由于批处理任务运行在 Liberty 服务器进程中，服务器会自动注入 JNDI 环境属性，无需手动配置：

修改代码 #

简化初始化逻辑，直接创建InitialContext：

public void initialContext() {
    try {
        initialContext = new InitialContext();
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

可选：跨服务器访问时的手动配置 #

若需访问其他 Liberty 服务器的 EJB，可手动指定属性（使用 CORBA 标准的corbaloc格式 URL）：

public void initialContext() {
    Properties props = new Properties();
    props.put(InitialContext.INITIAL_CONTEXT_FACTORY, 
              "com.ibm.websphere.naming.WsnInitialContextFactory");
    props.put(InitialContext.PROVIDER_URL, 
              "corbaloc::remote-host:2809/NameService");
    // 若目标服务器启用认证，添加以下属性
    // props.put(Context.SECURITY_PRINCIPAL, "username");
    // props.put(Context.SECURITY_CREDENTIALS, "password");

    try {
        initialContext = new InitialContext(props);
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

验证服务器配置 #

确保server.xml已启用必要特性（你当前的配置已满足）：

<featureManager>
    <feature>jakartaee-10.0</feature>
    <feature>jakartaeeClient-10.0</feature>
    <feature>iiopEndpoint-1.0</feature>
    <feature>iiopClient-1.0</feature>
    <feature>enterpriseBeans-4.0</feature>
    <feature>enterpriseBeansRemote-4.0</feature>
</featureManager>

2. 脚本（.bat/.sh）运行的独立批处理客户端 #

独立客户端需手动配置类路径和 JNDI 属性：

步骤1：配置类路径 #

将 Liberty 客户端 JAR 添加到类路径中：

Windows 批处理示例

set LIBERTY_HOME=C:\path\to\liberty-25.0.0.10
set CLASSPATH=%CLASSPATH%;%LIBERTY_HOME%\wlp\clients\wlp-clients.jar;your-app-batch.jar

Shell 脚本示例

LIBERTY_HOME=/path/to/liberty-25.0.0.10
CLASSPATH=$CLASSPATH:$LIBERTY_HOME/wlp/clients/wlp-clients.jar:your-app-batch.jar

步骤2：修改 JNDI 初始化代码 #

使用正确的工厂类和 URL：

public void initialContext() {
    Properties props = new Properties();
    props.put(InitialContext.INITIAL_CONTEXT_FACTORY, 
              "com.ibm.websphere.naming.WsnInitialContextFactory");
    props.put(InitialContext.PROVIDER_URL, 
              "corbaloc::localhost:2809/NameService");
    // 服务器启用认证时添加
    // props.put(Context.SECURITY_PRINCIPAL, "batch-user");
    // props.put(Context.SECURITY_CREDENTIALS, "user-password");

    try {
        initialContext = new InitialContext(props);
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

步骤3：验证服务器端点配置 #

确保 Liberty 服务器的 IIOP 端点正常启动，可在server.xml中显式配置（默认已启用）：

<iiopEndpoint id="defaultIiopEndpoint" host="localhost" port="2809"/>

额外排查点 #

• 确保wlp-clients.jar版本与 Liberty 25.0.0.10 完全匹配，避免版本不一致问题。
• 独立客户端需包含应用自身的所有依赖 JAR，不要遗漏业务类。
• 查看 Liberty 服务器日志，确认 IIOP 端点是否正常启动，EJB 是否成功绑定到 JNDI 树。
• 若使用安全认证，确保服务器配置了用户注册表（如basicRegistry），且客户端用户拥有 EJB 访问权限。

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