IBM MQ调用失败（compcode '2'、reason '2059'）远程连接求助

我来帮你排查这个远程连接IBM MQ时遇到的2059错误——这是远程MQ连接场景里最常见的问题之一，咱们一步步梳理可能的原因和解决办法：

先明确错误含义 #

错误码2059（MQRC_Q_MGR_NOT_AVAILABLE）本质是客户端无法与目标队列管理器建立有效连接，可能涉及网络、配置、安全等多个层面，咱们从最基础的开始查：

1. 先确认网络连通性 #

远程连接第一步肯定是网络能通：

• 用命令测试端口是否可达：telnet 192.168.1.107 1414 或者 nc -zv 192.168.1.107 1414。如果连不通，说明要么是服务器防火墙拦截了1414端口，要么是网络路由有问题，先找运维搞定网络。
• 还要确认远程MQ服务器的监听端口真的是1414：在MQ服务器上执行DISPLAY LISTENER(*) PORT命令，查看实际监听的端口号，别被默认值误导。

2. 检查队列管理器与通道配置 #

网络通了之后，就得看MQ本身的配置：

• 确认远程队列管理器处于运行状态：在服务器上执行DISPLAY QMGR STATUS，看返回的STATUS字段是不是RUNNING，要是队列管理器都没启动，肯定连不上。
• 检查你要连接的SVRCONN通道是否存在且运行：JMS客户端远程连接MQ必须用SVRCONN类型的通道（比如默认的SYSTEM.DEF.SVRCONN，或者你自定义的通道）。在服务器上执行DISPLAY CHANNEL(你的通道名)，确认CHLTYPE=SVRCONN且STATUS=RUNNING。
• 注意通道认证规则（CHLAUTH）：如果MQ服务器启用了CHLAUTH，可能会拦截你的连接请求。可以先临时禁用测试（SET CHLAUTH(*) TYPE(DISABLED)），如果能连上了，再针对性配置允许你的客户端IP或用户通过通道，比如：

  SET CHLAUTH(你的通道名) TYPE(ADDRESSMAP) ADDRESS(你的客户端IP) USERSRC(CHANNEL)
  

3. 补全客户端连接参数 #

你贴的代码里缺少了两个远程连接必须的关键参数——本地连接可能因为默认值能正常工作，但远程连接必须明确指定：

• 队列管理器名称：cf.setQueueManager("你的远程QMGR名称")（MQ名称区分大小写，别写错）
• SVRCONN通道名称：cf.setChannel("你的远程通道名称")

给你补全后的代码示例：

private static void foo() throws JMSException { 
    Request request = new Request(); 
    request.setRequestKey("11-12347"); 
    request.setQueryString("This is a query string!"); 

    MQQueueConnectionFactory cf = new MQQueueConnectionFactory(); 
    cf.setHostName("192.168.1.107"); 
    cf.setPort(1414);
    // 补充远程连接必需的参数
    cf.setQueueManager("YOUR_REMOTE_QMGR"); // 替换成实际的队列管理器名称
    cf.setChannel("YOUR_SVRCONN_CHANNEL"); // 替换成实际的SVRCONN通道名称
    cf.setTransportType(JMSC.MQJMS_TP_CLIENT_MQ_TCPIP); // 指定TCPIP传输类型

    // 如果需要认证
    Connection connection = cf.createConnection("YOUR_USER_ID", "YOUR_PASSWORD");
    // 后续创建会话、发送消息的逻辑...
}

4. 安全权限检查 #

如果你尝试了带用户ID/密码连接，得确认权限足够：

• 该用户需要有连接队列管理器的权限：在服务器上执行SET AUTHREC PROFILE(QMGR) OBJTYPE(QMGR) PRINCIPAL(你的用户ID) AUTHADD(CONNECT)
• 还需要有向目标队列发消息的权限：SET AUTHREC PROFILE(你的目标队列名) OBJTYPE(QUEUE) PRINCIPAL(你的用户ID) AUTHADD(PUT)
• 另外检查队列管理器的连接认证（CONNAUTH）设置：执行DISPLAY QMGR CONNAUTH，如果启用了连接认证，必须提供正确的用户密码，否则会被拒绝。

5. 版本兼容性检查 #

确保你用的JMS客户端版本和服务器的9.0.0.0兼容——尽量保持客户端和服务器版本一致，或者在IBM官方支持的兼容范围内，版本差异过大可能导致协议不兼容，引发连接失败。

内容的提问来源于stack exchange，提问作者Hanash Abdurabuh