MuleSoft Runtime 4.4下Anypoint Studio MDC日志变量不展示问题问询

MuleSoft 4.4 MDC自定义变量不输出故障排查方案 #

官方预期日志格式参考：
INFO 2021-04-08 16:58:26,882 [[MuleRuntime].uber.15: [test-project-app].exmapleFlow.CPU_LITE @18f679] [{correlationId=c85e16c0-98a4-11eb-bc34-cac765a2219b, processorPath=exmapleFlow/processors/2, testVar=testValue}] org.mule.runtime.core.internal.processor.LoggerMessageProcessor: Example

1. 日志模板未配置MDC字段输出（最高发原因） #

Mule 4.4默认的日志输出模板不会自动打印自定义MDC变量，需要手动修改日志配置：

• 定位到项目src/main/resources/log4j2.xml文件
• 找到控制台/文件输出对应的Appender节点，修改PatternLayout的pattern属性，添加%X占位符输出所有MDC变量，或者指定输出单个变量%X{变量名}
  正确配置示例：

  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p [%t] [%X] %c: %m%n"/>
    </Console>
  </Appenders>
  

2. MDC变量设置方式错误 #

不能用普通Set Variable组件设置MDC变量，必须使用4.4新增的专用组件：

• 确认你使用的是Core模块下的Set MDC variable组件配置自定义变量
• 变量名不要和Mule默认保留MDC字段（correlationId、processorPath等）重名

3. 跨线程MDC未开启传播 #

如果在异步组件（async、并行foreach、异步HTTP调用等）中设置MDC变量，默认不会跨线程传递：

• 打开src/main/resources/mule-artifact.json，在props节点添加配置：

  "props": {
    "com.mulesoft.mule.runtime.core.thread.context.mdc.propagation": "ALL"
  }
  

• CloudHub部署场景需要额外在运行时属性中添加上述参数

4. 运行时版本不兼容 #

• 确认mule-artifact.json中minMuleVersion配置为4.4.0及以上
• 确认Anypoint Studio绑定的运行时环境版本不低于4.4.0

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