使用Citrus框架向WebSphere MQ发消息时无法设置Message ID

我之前也碰到过一模一样的问题，这其实是IBM MQ的JMS实现特性加上Citrus的头配置规则共同导致的，下面给你一步步拆解解决方案：

为什么Message ID设置不了？ #

IBM WebSphere MQ的JMS客户端默认会自动生成并管控JMSMessageID，你手动设置的值会被MQ直接忽略——除非你明确配置MQ连接工厂，允许应用修改MQMD（MQ Message Descriptor）里的Message ID字段。

解决方案步骤 #

1. 配置MQ连接工厂，开启自定义Message ID权限 #

你需要在MQ连接工厂的配置中添加两个关键属性：

• wmqMQMDWriteEnabled：允许应用修改MQMD字段
• wmqMessageId：明确允许自定义Message ID

如果是用Spring XML配置连接工厂，示例如下：

<bean id="mqConnectionFactory" class="com.ibm.mq.jms.MQConnectionFactory">
    <!-- 基础MQ连接配置 -->
    <property name="hostName" value="${mq.host}"/>
    <property name="port" value="${mq.port}"/>
    <property name="queueManager" value="${mq.queueManager}"/>
    <property name="channel" value="${mq.channel}"/>
    <property name="transportType" value="1"/> <!-- 客户端传输类型 -->
    
    <!-- 开启MQMD修改权限 -->
    <property name="wmqMQMDWriteEnabled" value="true"/>
    <!-- 允许自定义Message ID -->
    <property name="wmqMessageId" value="true"/>
</bean>

2. 在Citrus配置中正确设置JMS Message ID #

注意：Citrus里设置JMS标准头和自定义应用头的方式不一样，不能直接用普通的<element>标签设置Message ID，需要使用jms_前缀的头名称：

修改你的Citrus发送配置：

<send endpoint="QueueEndPoint">
    <message>
        <resource file="c:\payloads\payload.xml"/>
        <headers>
            <!-- 自定义应用头正常设置 -->
            <element name="Scenario" value="some thing"/>
            <!-- 正确设置JMS Message ID，使用jms_前缀 -->
            <element name="jms_messageId" value="YOUR-CUSTOM-MESSAGE-ID-HERE"/>
            <!-- Correlation ID同样用jms_correlationId前缀 -->
            <element name="jms_correlationId" value="YOUR-CORRELATION-ID-HERE"/>
        </headers>
    </message>
</send>

如果是用Citrus Java DSL编写测试，代码示例：

send("QueueEndPoint")
    .message(new PayloadResource("c:/payloads/payload.xml"))
    .header("Scenario", "some thing")
    // 使用Citrus的JMS头常量更规范
    .header(JmsMessageHeaders.MESSAGE_ID, "YOUR-CUSTOM-MESSAGE-ID-HERE");

3. 验证配置是否生效 #

发送测试消息后，通过MQ Explorer或者MQ命令行工具（比如amqsbcg）查看消息的MQMD信息，确认Message ID是否为你自定义的值。如果还是不生效，检查队列管理器的配置，确保没有禁止应用修改Message ID的权限。

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