从WebSphere Liberty连接IBM MQ时的JNDI查找异常问题

问题分析 #

从传统WebSphere Application Server 8.5迁移到WebSphere Liberty后，应用通过JNDI查找jms/queueconnfactory时抛出异常：Name jms not found in context "serverlocal:CELLROOT/SERVERROOT"，核心原因是传统WAS与Liberty的JNDI初始化方式存在差异，代码中沿用了传统WAS的上下文配置，导致无法正确识别Liberty的本地JNDI命名空间。

解决方案 #

1. 修改JNDI初始化代码 #

在Liberty容器内运行的应用，无需手动指定JNDI工厂类和提供者URL，直接使用无参的InitialContext即可获取容器提供的上下文：

// 移除原有Properties配置，改用无参构造
InitialContext initialContext = new InitialContext();
connFactory = (QueueConnectionFactory) initialContext.lookup("jms/queueconnfactory");

如果确实需要显式配置（例如跨服务器远程查找），需替换为Liberty对应的JNDI工厂类：

Properties properties = new Properties();
properties.put("java.naming.factory.initial", "com.ibm.ws.naming.util.WsnInitCtxFactory");
// 远程查找时需指定providerURL，格式为corbaloc::host:port
// properties.put("java.naming.provider.url", "corbaloc::localhost:2809");
InitialContext initialContext = new InitialContext(properties);
connFactory = (QueueConnectionFactory) initialContext.lookup("jms/queueconnfactory");

2. 验证server.xml配置 #

• 确认jmsQueueConnectionFactory的jndiName属性值与代码中查找的名称完全一致（jms/queueconnfactory），无拼写错误。
• 确保wmqJmsClient-2.0、jndi-1.0特性已正确添加到featureManager中（你的配置已满足）。

3. 排查日志确认绑定状态 #

查看Liberty安装目录下logs/messages.log，搜索jms/queueconnfactory，确认是否存在类似以下的成功绑定日志：

CWWKZ0001I: Application your-app-name started in X seconds.
CWMQ1001I: JMS Queue Connection Factory jms/queueconnfactory has been created.

如果存在绑定失败的日志，根据提示修正配置（例如MQ连接参数错误、SSL配置问题等）。

内容的提问来源于stack exchange，提问作者Maria Raja Selvan