使用MQHMDE头发送消息时遭遇MQRC_HEADER_ERROR(2142)问题求助

问题根源 #

MQRC_HEADER_ERROR(2142)的核心原因是：你设置了JMS_IBM_Format = MQFMT_MD_EXTENSION（即MQHMDE头），但发送的是普通字符串消息——MQ要求使用该格式头时，消息体必须是符合MQHMDE规范的二进制结构化数据，普通字符串与该格式不匹配，触发校验失败。

解决步骤 #

1. 明确MQHMDE的使用要求 #

MQHMDE是MQMD的扩展头，属于二进制结构体，并非单纯的格式标识。只有当你的消息体确实是序列化后的MQHMDE数据时，才能设置MQFMT_MD_EXTENSION格式值。如果只是需要传递普通文本消息，请勿使用该格式头。

2. 调整消息构造方式 #

如果确实需要发送MQHMDE格式的消息，需构造MQHMDE对象并序列化为字节数组作为消息体，示例代码如下（结合Apache Camel）：

import com.ibm.mq.MQHMDE;
import com.ibm.mq.constants.MQConstants;
import org.apache.camel.builder.RouteBuilder;

public class MQRoute extends RouteBuilder {
    @Override
    public void configure() throws Exception {
        from("direct:sendHMDEMsg")
            // 设置MQ格式头为MQHMDE
            .setHeader("JMS_IBM_Format", constant(MQConstants.MQFMT_MD_EXTENSION))
            .setHeader("JMS_IBM_Encoding", constant(500))
            .setHeader("JMS_IBM_Character_Set", constant(785))
            // targetClient=1表示由应用处理原生MQ头，避免JMS客户端自动转换
            .setHeader("CamelJmsDestinationName", constant("queue:///queueName?targetClient=1"))
            // 构造MQHMDE结构体并序列化为字节数组
            .process(exchange -> {
                MQHMDE hmde = new MQHMDE();
                hmde.setVersion(MQConstants.MQHMDE_VERSION_1);
                // 根据业务需求设置其他字段，比如hmde.setCorrelId(...)等
                exchange.getMessage().setBody(hmde.getBytes());
            })
            .to("jms:queue:queueName");
    }
}

3. 修正Camel配置 #

• targetClient参数：建议设置为1，让应用直接处理MQ原生头，避免JMS客户端自动转换头信息导致格式冲突。若设置为0，MQ会自动处理JMS到MQ头的映射，可能破坏MQHMDE的格式要求。
• 编码与字符集：确保JMS_IBM_Encoding(500)和JMS_IBM_Character_Set(785)与MQHMDE结构体中字符串字段的编码一致，若结构体中无字符串字段，这两个参数不影响二进制结构，但需保持与MQ队列的配置兼容。

4. 排查其他可能原因 #

• 检查MQ队列的属性配置，是否有强制的格式校验规则。
• 确认使用的IBM MQ客户端版本与MQ服务器版本兼容，部分版本对MQHMDE的处理有差异。

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