使用MQPUT函数发送带RFH2头消息时遇2142错误（无效MQ头结构）

我来帮你梳理这个问题——你遇到的2142（MQRC_RFH2_STRUCTURE_ERROR）确实是RFH2头的结构不符合MQ的解析要求，结合你给出的MQMD信息，咱们从几个核心点排查：

1. 先确认RFH2头的基础结构字段 #

这是最容易踩坑的地方，必须严格匹配MQ的要求：

• 检查StrucId字段：必须是'RFH '（注意最后有一个空格，占4字节），如果少了空格或者拼写错误，直接触发这个报错。
• 检查Version字段：通常设置为2（对应MQRFH2_VERSION_2），版本不匹配也会导致结构识别失败。
• 检查StrucLength字段：这个值必须是RFH2整个结构的准确字节长度，包括固定部分和后面的可变XML属性部分，长度计算错误会让MQ认为头被截断或多余，判定为无效结构。

2. 结合你的MQMD参数排查关联问题 #

你给出的MQMD里有几个关键参数可以辅助排查：

• Format='MQHRF2 '：这个设置是正确的（注意后面的空格，MQ的格式字段都是8字节补空格），说明你明确告诉MQ这是带RFH2头的消息，这部分没问题。
• MsgType=8（MQMT_DATAGRAM）：消息类型没问题，但要确认RFH2头和消息体的拼接是否正确——有没有出现字节截断、多余的填充字节，或者头和体的顺序搞反了？
• Encoding=273（IBM-PC小端字节序）和CodedCharSetId=1208（UTF-8）：要确保RFH2头里的NameValueCCSID字段和CodedCharSetId一致（也就是1208），同时RFH2的XML属性部分确实是UTF-8编码的，编码不匹配会导致MQ解析头时出现乱码，进而判定结构无效。

3. 检查RFH2的XML属性部分格式 #

MQ对RFH2里的XML内容要求非常严格，哪怕一个小语法错误都会触发2142：

• 确保XML标签完全闭合，没有嵌套错误；
• 避免使用XML非法字符（比如未转义的&、<、>等）；
• 确认命名空间的格式符合MQ规范，比如常见的<usr>或<mqext>命名空间有没有正确定义。

4. 字节顺序匹配问题 #

因为你设置了Encoding=273（小端字节序），要确保RFH2头里的所有数值型字段（比如StrucLength、Version、NameValueCCSID）都是按照小端字节序存储的。如果你的代码运行在大端字节序的系统上，却没有做字节序转换，MQ解析出来的字段值会完全错误，自然会认为头结构无效。

小建议 #

可以用MQ自带的工具（比如amqsput命令行工具或者MQ Explorer图形界面）发送一条带RFH2头的测试消息，然后用消息查看工具对比你自己代码生成的消息结构，这样能快速定位到哪部分字段或格式不一致。

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