向IBM MQ 9队列发消息报host name null连接失败问题

报错中显示的host name 'null'是IBM MQ JMS客户端的异常信息生成缺陷，属于误导性提示。你配置的WMQ_HOST_NAME参数本身可以被正常读取，真正的连接失败原因是异常栈中明确标记的MQRC_UNSUPPORTED_CIPHER_SUITE（原因码2400）：你配置的SSL密码套件与服务端要求、当前运行环境的支持能力不匹配，连接在SSL握手初始化阶段就直接中断，异常组装时还未完成主机名参数的上下文填充，因此会显示主机名为null。

另外你的源码中存在一处显性语法错误：配置信任库路径的代码System.setProperty("javax.net.ssl.trustStore", path_to_cacerts");缺失了路径值开头的双引号，这会导致信任库路径配置完全不生效，是触发SSL协商失败的常见诱因。

1. 修正代码基础错误 #

将SSL相关系统参数配置移动到MQ连接工厂初始化逻辑之前，同时补全语法错误，避免类加载顺序或语法问题导致配置失效：

// 优先配置SSL全局参数
System.setProperty("com.ibm.mq.cfg.useIBMCipherMappings", "false");
System.setProperty("javax.net.ssl.trustStore", "path_to_cacerts"); // 补全路径开头的双引号
System.setProperty("javax.net.ssl.trustStorePassword", "pass");
// 若为双向SSL认证，需取消下方注释并配置正确的客户端密钥库路径
//System.setProperty("javax.net.ssl.keyStore", "path_to_jks");
//System.setProperty("javax.net.ssl.keyStorePassword", "pass");

// 再初始化连接工厂
JmsFactoryFactory ff = JmsFactoryFactory.getInstance(WMQConstants.WMQ_PROVIDER);
JmsConnectionFactory cf = ff.createConnectionFactory();

// 原有HOST、PORT、CHANNEL等连接参数配置逻辑保持不变
cf.setStringProperty(WMQConstants.WMQ_HOST_NAME, HOST_NAME);
cf.setIntProperty(WMQConstants.WMQ_PORT, PORT);
cf.setStringProperty(WMQConstants.WMQ_CHANNEL, CHANNEL);
cf.setIntProperty(WMQConstants.WMQ_CONNECTION_MODE, WMQConstants.WMQ_CM_CLIENT);
cf.setStringProperty(WMQConstants.WMQ_QUEUE_MANAGER, QUEUE_MANAGER);
cf.setStringProperty(WMQConstants.WMQ_APPLICATIONNAME, "JmsPutGet (JMS)");
cf.setBooleanProperty(WMQConstants.USER_AUTHENTICATION_MQCSP, true);
// 若队列管理器开启账号认证，需取消下方注释配置正确的账号密码
//cf.setStringProperty(WMQConstants.USERID, APP_USER);
//cf.setStringProperty(WMQConstants.PASSWORD, APP_PASSWORD);
cf.setStringProperty(WMQConstants.WMQ_SSL_CIPHER_SUITE, SSL_CIPHER_SUITE);
cf.setStringProperty(WMQConstants.WMQ_SSL_PEER_NAME, SSL_PEER_NAME);

2. 对齐SSL密码套件配置 #

你已经配置com.ibm.mq.cfg.useIBMCipherMappings=false，这个配置在OpenJDK/Oracle JRE环境下是正确的，接下来需要确认密码套件参数的匹配性：

• 联系MQ服务端管理员确认对应SVRCONN通道配置的SSLCIPH参数值，传入WMQ_SSL_CIPHER_SUITE的套件名必须是标准JSSE格式（即带TLS_前缀的名称，例如TLS_RSA_WITH_AES_128_CBC_SHA256），不能使用IBM JRE专属的短套件名。
• 确认当前运行的JRE版本支持你配置的密码套件：AES_256强度的套件在JDK 8u161之前的版本需要手动安装JCE无限制权限策略文件才能启用，高版本JDK默认已开启该支持。
• 如果需要先排查基础连通性，可以暂时注释掉WMQ_SSL_CIPHER_SUITE和WMQ_SSL_PEER_NAME两个参数，关闭SSL配置先验证普通TCP连接是否正常，确认主机、端口、通道、队列管理器配置无误后再逐步开启SSL能力。

3. 关于host name为null的补充说明 #

该现象是IBM MQ 9.0.x早期版本客户端的已知问题，只要连接失败发生在连接参数上下文组装完成前（比如SSL参数校验阶段、网络初始化阶段），异常信息中都会显示主机名为null，不需要单独针对主机名配置做排查，解决根因后该提示会自然消失。

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