Mule 4.4中X-Correlation-Id为何在HTTP请求中隐式传递？

问题 #

使用Mule runtime 4.4部署了两个API：API 1接收HTTP请求后调用API 2。API 1收到包含以下两个请求头的GET请求：

X-Correlation-Id = abcd
X-Channel = Music

API 1调用API 2时未主动传递任何请求头，但API 2收到请求时却能看到X-Correlation-Id = abcd（不符合预期），而X-Channel = Music则缺失（符合预期）。

API 1配置代码 #

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:http="http://www.mulesoft.org/schema/mule/http" xmlns="http://www.mulesoft.org/schema/mule/core"
    xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">
    <http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="f1bec56d-de65-4a93-913d-07a7426d6bf6" >
        <http:listener-connection host="0.0.0.0" port="9091" />
    </http:listener-config>
    <http:request-config name="HTTP_Request_configuration" doc:name="HTTP Request configuration" doc:id="7040eda0-aff5-47c2-8682-be73489e2c2c" >
        <http:request-connection host="localhost" port="9092" />
    </http:request-config>
    <flow name="header_pass_01Flow" doc:id="dc0c28a7-c277-4192-b641-e73af8afbde3" >
        <http:listener doc:name="Listener" doc:id="57e56cd6-a47e-456b-8c6d-e57627c673b8" path="/pass/*" config-ref="HTTP_Listener_config"/>
        <logger level="INFO" doc:name="Logger" doc:id="6df37e5e-a491-421c-a642-742059107d95" message="before call to api 1"/>
        <http:request method="GET" doc:name="Request" doc:id="a6765e5d-40f5-4abd-bff6-d6e6a80eecdf" config-ref="HTTP_Request_configuration" path="/receive/all"/>
        <logger level="INFO" doc:name="Logger" doc:id="e250696f-7109-42a4-a50c-586fc164fed9" message="after call to api 1"/>
    </flow>
</mule>

API 2配置代码 #

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:http="http://www.mulesoft.org/schema/mule/http" xmlns="http://www.mulesoft.org/schema/mule/core"
    xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">
    <http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="a1f75f77-5ff5-4346-866e-0f1ce1679e57">
        <http:listener-connection host="0.0.0.0" port="9092" />
    </http:listener-config>
    <flow name="header_receive_01Flow" doc:id="433cc316-549d-4349-86ba-68e3571a5716" >
        <http:listener doc:name="Listener" doc:id="d3677aa5-bd38-41d4-ba33-cb4a8a1fd2b2" config-ref="HTTP_Listener_config" path="/receive/*"/>
        <logger level="INFO" doc:name="Logger" doc:id="6999dea6-c369-4813-a5e6-8e81ec98ef60" message="received call"/>
    </flow>
</mule>

原因分析 #

Mule runtime 4的HTTP请求组件（http:request）默认会自动传递关联ID相关的请求头，这是Mule为支持分布式追踪、请求链路追踪设计的内置行为。

当API 1的HTTP监听器收到X-Correlation-Id头时，Mule会把这个值绑定到当前Mule事件的correlationId属性中。后续调用HTTP请求组件时，组件会自动将事件的correlationId以X-Correlation-Id头的形式传递给下游服务，无需手动配置。

而X-Channel这类自定义头不属于Mule默认自动传递的范畴，所以不会被隐式传递，符合预期。

禁止自动传递的方法 #

如果不需要这个默认行为，可以在http:request组件中添加disableCorrelationId="true"属性，关闭自动传递关联ID的功能：

<http:request method="GET" doc:name="Request" doc:id="a6765e5d-40f5-4abd-bff6-d6e6a80eecdf" 
    config-ref="HTTP_Request_configuration" path="/receive/all"
    disableCorrelationId="true"/>

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