升级至camel-azure-servicebus-4.4.2后CamelAzureServiceBus头丢失如何恢复？

问题根源 #

升级到camel-azure-servicebus-4.4.2后丢失CamelAzureServiceBus前缀头，是因为CAMEL-20596的变更：该版本默认不再将Azure Service Bus原生属性（如SequenceNumber、DeliveryCount等）映射为带CamelAzureServiceBus前缀的Camel消息头，转而将这些属性存入Exchange的properties集合中，以此避免头名称冲突。

恢复方案 #

方案一：启用旧版头映射兼容模式 #

在ServiceBusConfiguration配置中添加transferServiceBusProperties属性并设为true，即可恢复原有映射逻辑，让Azure Service Bus原生属性重新生成带CamelAzureServiceBus前缀的消息头。

修改后的XML配置如下：

<bean id="azureServiceBusComponent" class="org.apache.camel.component.azure.servicebus.ServiceBusComponent">
    <property name="configuration">
        <bean class="org.apache.camel.component.azure.servicebus.ServiceBusConfiguration">
            <property name="credentialType" value="TOKEN_CREDENTIAL" />
            <property name="tokenCredential" ref="azauth" />
            <property name="fullyQualifiedNamespace" value="elexon-iris.servicebus.windows.net" />
            <!-- 启用兼容模式，恢复原有头映射 -->
            <property name="transferServiceBusProperties" value="true" />
        </bean>
    </property>
</bean>

方案二：调整业务逻辑读取Exchange属性 #

若不想启用兼容模式，可修改处理脚本，直接从Exchange的properties中获取对应属性。属性名称对应原头名称去掉CamelAzureServiceBus前缀的部分（例如原CamelAzureServiceBusSequenceNumber对应SequenceNumber）。

以Camel表达式为例，访问方式为exchangeProperty(SequenceNumber)，具体语法需根据你的脚本环境调整。

验证 #

修改配置或脚本后重启服务，发送测试消息检查是否恢复所需头信息，确认业务过滤逻辑正常运行。

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