IBM MQ Java读取消息格式异常：MQSTR显示却读出MQHRF2

算力阿峰

2026-7-24

问题分析与解决方法

原因说明

MQHRF2格式表示消息带有RFH2头部：MQ Explorer会自动解析该头部，显示消息体的实际格式（即MQSTR），但你的Java代码读取的是原始消息的format字段，该字段标记的是包含头部的整体格式。这种情况常见于消息通过JMS客户端发送（JMS默认添加RFH2头部携带属性），或者队列/通道配置触发了RFH2头部的添加。

解决方法

方法1：启用服务器自动转换

在获取消息时，给MQGetMessageOptions添加MQGMO_CONVERT选项，让MQ服务器自动处理RFH2头部，转换后format字段会显示消息体的实际格式：

MQMessage getMessage = new MQMessage();
getMessage.clearMessage();
MQGetMessageOptions mqGetMessageOptions = new MQGetMessageOptions();
// 添加自动转换选项
mqGetMessageOptions.options |= MQC.MQGMO_CONVERT;
queue.get(getMessage, mqGetMessageOptions);
String format = getMessage.format.trim();

方法2：手动解析RFH2头部

如果不想依赖服务器转换，可以手动解析RFH2头部，从中提取实际的消息体格式：

MQMessage getMessage = new MQMessage();
getMessage.clearMessage();
MQGetMessageOptions mqGetMessageOptions = new MQGetMessageOptions();
queue.get(getMessage, mqGetMessageOptions);

String format = getMessage.format.trim();
// 检查是否为RFH2格式
if (MQC.MQFMT_RF_HEADER_2.equals(format)) {
    RFH2 rfh2 = new RFH2(getMessage);
    // 从RFH2的usr字段中获取实际格式
    format = rfh2.getFieldValue("usr", "Format").trim();
    // 重置消息指针到消息体起始位置（若后续需读取消息体）
    getMessage.setMessageLength(getMessage.getMessageLength() - rfh2.getTotalLength());
    getMessage.seek(rfh2.getTotalLength());
}