Node.js使用ibmmq获取MQ队列消息时附带RFH头如何提取纯业务消息

你读取到的额外前缀内容是MQ RFH2（规则与格式化头），是JMS类客户端（比如JMeter JMS插件）投递消息时默认携带的元数据块，包含消息类型、目标地址、投递时间等JMS协议属性。rfhutil默认开启了RFH2头自动剥离逻辑，所以Data标签页只会展示纯业务载荷。

你当前代码的问题有两点：

• 配置消息读取选项（GMO）时没有开启属性自动处理参数，MQ客户端直接把RFH2头+业务载荷整个当做缓冲区返回
• 格式判断只匹配了MQSTR（纯字符串格式），没有识别MQHRF2（RFH2头格式），没有做头和载荷的拆分

方案1：配置读取选项自动剥离RFH2头（推荐） #

在构造消息读取参数GMO时，加上MQGMO_PROPERTIES_IN_HANDLE选项，MQ客户端会自动把RFH2里的元数据解析为消息属性挂载到句柄上，不会把RFH2头拼到返回的消息缓冲区中，拿到的buf直接就是纯业务内容。
示例代码：

const mq = require('ibmmq');
const MQC = mq.MQC;

// 初始化消息读取选项
const gmo = new mq.MQGMO();
gmo.Options = MQC.MQGMO_NO_SYNCPOINT |
              MQC.MQGMO_CONVERT |
              MQC.MQGMO_FAIL_IF_QUIESCING |
              MQC.MQGMO_PROPERTIES_IN_HANDLE; // 核心配置，自动剥离RFH2头

配置后你原来的回调逻辑不需要改动，md.Format会直接被置为MQSTR，buf就是纯XML业务内容，可以直接做XSL转换。

如果加了这个选项还是拿到RFH2头，需要检查对应队列的PROPCTL配置，把队列属性改成PROPCTL(COMPAT)即可，不要用PROPCTL(FORCE)——该配置会强制所有客户端都把RFH2头放进消息体返回。

方案2：手动解析RFH2头拆分业务载荷 #

如果你需要保留RFH2里的元数据信息，可以用ibmmq模块内置的RFH2结构解析方法，按二进制结构准确计算头长度，再切分缓冲区，不要用字符串匹配截取（RFH2是二进制结构，存在非可见字符，字符串截取很容易出现偏移错误）。
示例代码：

function getCB(err, hObj, gmo, md, buf, hConn) {
  if (err) {
    // 原有错误处理逻辑
    console.error(err);
    return;
  }
  let realContent;
  // 识别RFH2头格式，MQ格式字段为固定8位长度，使用模块内置常量可避免空格补全错误
  if (md.Format === MQC.MQFMT_RF_HEADER_2) {
    const rfh2Header = new mq.MQRFH2();
    // 从缓冲区解析RFH2头
    rfh2Header.getBuffer(buf);
    // 按头结构里记录的StrucLength偏移，切出后面的真实业务内容
    realContent = buf.slice(rfh2Header.StrucLength);
  } else if (md.Format === MQC.MQFMT_STRING) {
    realContent = buf;
  } else {
    // 原有二进制消息处理逻辑
    console.log("binary message: " + buf);
    return;
  }
  // 转码后拿到纯业务字符串
  const contentStr = decoder.write(realContent);
  console.log("业务消息内容：", contentStr);
}

两种方案和rfhutil的处理逻辑完全一致：rfhutil默认开启了自动属性处理，识别到RFH2头时会自动跳过头部长度，只渲染后面的业务载荷部分，不会展示元数据内容。

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