部署在WebSphere Liberty的Spring Boot应用JNDI查找失败问题排查

核心问题分析 #

报错Intermediate context does not exist: jms/B24ZIISC_QCF本质是目标JNDI资源未成功注册到Liberty的命名服务，或Spring应用的JNDI查找上下文不正确。本地使用内置消息引擎（wasJmsServer）正常，但切换到IBM MQ环境时，Liberty的特性配置、资源初始化逻辑存在关键差异，这是问题根源。

分步解决方案 #

1. 修正Liberty特性配置 #

本地依赖的wasJmsServer-1.0是内置消息引擎特性，IBM MQ环境无需该特性，需替换为MQ客户端特性。更新featureManager：

<featureManager>
   <feature>localConnector-1.0</feature>
   <feature>servlet-4.0</feature>
   <feature>jaxb-2.2</feature>
   <feature>jpaContainer-2.2</feature>
   <!-- 移除wasJmsServer，替换为MQ客户端特性 -->
   <feature>wmqJmsClient-2.0</feature>
   <feature>appSecurity-2.0</feature>
   <feature>restConnector-2.0</feature>
   <feature>jsp-2.3</feature>
</featureManager>

注：wmqJmsClient-2.0适配Java 8与Liberty 23.0.0.9，若Liberty未预装该特性，可通过featureManager install wmqJmsClient-2.0命令安装。

2. 验证MQ连接工厂的变量配置 #

部署环境server.xml中的占位符变量（如${B00_WMQ_ESB_JMS_PROPERTIES_HOST_NAME}）需确保正确赋值：

• 检查Liberty的server.env文件，确认所有MQ相关变量已配置
• 查看Liberty启动日志，确认变量已被正确解析（无${xxx}格式残留）
• 若变量未解析，连接工厂会初始化失败，无法注册到JNDI

3. 调整Spring的JNDI查找逻辑 #

默认JndiTemplate可能使用应用本地JNDI上下文，需明确指定全局JNDI名称或配置正确的上下文参数：

@Bean
public ConnectionFactory cf() throws NamingException {
    JndiTemplate jndiTemplate = new JndiTemplate();
    Properties jndiProps = new Properties();
    // 指定Liberty的JNDI初始上下文工厂
    jndiProps.put(Context.INITIAL_CONTEXT_FACTORY, "com.ibm.websphere.naming.WsnInitialContextFactory");
    jndiTemplate.setEnvironment(jndiProps);
    // 使用全局JNDI名称查找
    return jndiTemplate.lookup("java:global/jms/B24ZIISC_QCF", ConnectionFactory.class);
}

也可使用@JndiLookup注解简化配置：

@Bean
@JndiLookup(jndiName = "java:global/jms/B24ZIISC_QCF")
public ConnectionFactory cf() {
    return null; // 由容器注入实例
}

4. 检查MQ连接工厂的初始化状态 #

启动Liberty后，通过以下方式验证连接工厂是否成功注册：

• 访问Liberty管理控制台（默认https://localhost:9443/adminCenter），进入JNDI -> 全局命名空间，确认jms/B24ZIISC_QCF存在
• 查看Liberty的messages.log，搜索B24ZIISC_QCF，确认无初始化错误（如MQ服务器连接失败、SSL配置错误等）

5. 确保连接管理器配置正确 #

部署环境中引用的jmsConnectionManager需在server.xml中明确定义：

<connectionManager id="jmsConnectionManager" maxPoolSize="20" minPoolSize="5"/>

额外排查点 #

• 若使用SSL连接MQ，需确保Liberty的密钥库/信任库配置正确，且sslCipherSuite与MQ服务器配置匹配
• 检查Spring Boot的spring.jndi.*配置，避免覆盖Liberty的JNDI上下文设置
• 确认应用类加载策略（如parentLast）未干扰MQ客户端类的加载

内容的提问来源于stack exchange，提问作者Lyss P. Hacker