Spring Integration接收端丢失自定义IBM MQ JMS头部问题排查求助

这种自定义JMS头部丢失的问题确实挺棘手，尤其是已经初步排除Spring Integration嫌疑之后。结合你使用的IBM MQ 9.1.5.0客户端，我整理几个实用的排查方向，再说说你最终验证有效的解决办法：

排查方向 #

• 优先检查IBM MQ客户端的Target Client配置：这是这类问题最常见的根源。IBM MQ客户端默认的Target Client设置（MQJMS_CLIENT_NONJMS_MQ，值为1）会把JMS自定义属性转换成MQ专属的RFH2头部结构，而非标准JMS属性。这种情况下，Spring Integration的JMS接收端无法识别这些属性，自然就会出现“丢失”的现象。
• 验证发送端的消息属性是否正确添加：在发送端调用message.setStringProperty()之后，通过打印message.getPropertyNames()来确认自定义属性（比如fileName）确实已经被添加到消息中，排除发送端代码本身的疏漏。
• 直接查看队列中的消息结构：用MQ Explorer工具连接到MQ队列，直接查看待接收消息的头部信息。如果自定义属性出现在RFH2区块而非JMS属性区，那基本可以锁定是Target Client配置的问题。
• 快速验证Spring Integration接收配置：虽然你怀疑不是Spring的问题，但可以快速确认接收端的JmsMessageListenerContainer是否存在过滤属性的配置，比如是否开启了只提取消息体的设置（默认不会，但特殊配置可能导致）。

最终解决办法 #

你找到的方案完全正确：在发送端将Target Client设置为0（对应常量MQJMS_CLIENT_JMS_COMPLIANT）。这个配置会让IBM MQ客户端遵循标准JMS规范处理自定义属性，确保这些属性以标准JMS头部的形式传递，Spring Integration的接收端就能正常读取到所有自定义头部了。

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