JMS/Apache Camel中设置IBM MQ自定义属性不生效,读取报2471错误
IBM MQ自定义属性在JMS/Apache Camel中不生效的根因与实现
报错本质说明
抛出的MQException Completion Code 2, Reason 2471 对应MQ错误码MQRC_PROPERTY_NOT_AVAILABLE,核心含义是指定读取的属性在目标MQ消息的属性存储段中不存在。
已尝试方案的失效原因
- 方案三:
mQQueueConnectionFactory.setStringProperty("customProperty", "123")属于连接工厂的全局连接级配置操作,和单条消息的属性字段完全无关,不会被写入到具体的MQ消息负载中。 - 方案二:
exchange.getIn().setProperty("customProperty", "123")设置的是Camel Exchange上下文的运行时内部变量,这类变量仅存在于路由运行时内存中,永远不会被序列化到出站的JMS/MQ消息中,下游MQ原生API无法感知。 - 方案一:
exchange.getIn().setHeader("customProperty", "123")是最接近正确路径的实现,但受两个默认配置限制无法生效:- IBM MQ的JMS客户端默认仅允许JMS规范定义的标准header映射到底层MQMessage属性段,自定义header会被静默过滤存到JMS消息的私有字段,不会写入MQ原生可识别的属性段
- Camel JMS组件默认开启的属性名校验规则,会丢弃不符合JMS属性命名规范的自定义header,导致属性无法透传
- 额外的报错触发点:尝试读取的
messageGlobalSequenceNumber是MQ队列管理器在消息成功入队时自动生成的系统属性,不属于应用可自定义设置的字段范围,就算自定义属性设置流程正常,在发送端本地构造的MQMessage实例上读取该字段依然会抛出2471错误。
等效原生API的正确实现
要实现和原生IBM MQ API mQMessage.setStringProperty("customProperty", "123") 完全一致的效果,需要按以下步骤配置:
- 开启连接工厂的自定义属性透传开关
在IBM MQ连接工厂配置中,关闭自定义属性过滤规则,允许所有应用自定义属性写入底层MQMessage的属性存储段:MQQueueConnectionFactory cf = new MQQueueConnectionFactory(); // 配置所有自定义属性均可透传至MQ消息属性段 cf.setCustomProperty("customMessageProperties", "ALL"); - 通过正确路径写入消息属性
可以根据业务场景选择两种可靠的写入方式,确保属性被写入MQ原生可识别的存储段:- 方式一:直接调用JMS原生属性设置接口,和MQ原生API的行为完全对齐
from("direct:sendMQ") .process(exchange -> { // 获取出站JMS消息实例,直接设置字符串属性 jakarta.jms.Message jmsMsg = exchange.getIn(JmsMessage.class); jmsMsg.setStringProperty("customProperty", "123"); }) .to("ibm-mq:queue:TEST.QUEUE?connectionFactory=#mqConnFactory"); - 方式二:通过Camel Header写入,同时在端点层面开启自定义Header透传配置
from("direct:sendMQ") .setHeader("customProperty", constant("123")) // 关闭默认JMS消息转换,开启自定义Header映射开关 .to("ibm-mq:queue:TEST.QUEUE?connectionFactory=#mqConnFactory&mapJmsMessage=false&allowCustomHeaders=true");
- 方式一:直接调用JMS原生属性设置接口,和MQ原生API的行为完全对齐
- 属性读取的注意事项
发送端本地构造的MQMessage实例仅能读取应用手动设置的自定义属性;系统自动生成的messageGlobalSequenceNumber需要在消息成功被队列管理器接收、入队完成后,通过队列浏览的方式读取,发送端阶段无法获取该值。
内容的提问来源于stack exchange,提问作者Anu
相关产品推荐
相关产品推荐

