MDC.put设置的值未在Logback日志中显示问题求助

通过MDC.put设置了"ApigeeId"和"BasePath"键值对，调用MDC.get能正常获取对应值，但Logback输出的日志中这两个字段始终为空，对应位置显示[] []。

相关配置与代码 #

Logback配置（logback.xml）

<appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d  [%X{ApigeeId}] [%X{BasePath}] %-5level %-50logger{40} - %message%n</pattern>
    </encoder>
</appender>

代码片段

MDC.put("ApigeeId", apigeeId);
MDC.put("BasePath", "api/crm/sendemi");

实际输出日志

2023-01-11 13:13:09,286  [] [] INFO  org.hibernate.SQL_SLOW                             - SlowQuery: 14 milliseconds. SQL: 'HikariProxyPreparedStatement@1852998404 wrapping SQLServerPreparedStatement:12'

1. 检查线程上下文一致性 #

MDC基于**线程本地（ThreadLocal）**存储数据，如果日志输出线程和调用MDC.put的线程不是同一个，就会拿不到值。比如你在主线程设置MDC，但日志由异步线程（如连接池线程、异步任务线程）输出。

• 解决：异步场景下手动传递MDC上下文，示例代码：

// 复制当前线程的MDC上下文
Map<String, String> mdcContext = MDC.getCopyOfContextMap();
// 异步任务中加载上下文
CompletableFuture.runAsync(() -> {
    if (mdcContext != null) {
        MDC.setContextMap(mdcContext);
    }
    // 执行会输出日志的逻辑
    // ...
    // 任务结束后清理MDC，避免线程复用导致脏数据
    MDC.clear();
});

2. 排查MDC是否被提前清理 #

检查代码中是否在设置MDC后、日志输出前调用了MDC.clear()或MDC.remove()方法，这类操作会导致日志输出时字段为空。

3. 验证当前线程MDC有效性 #

在设置MDC后，直接在同一线程打印测试日志，确认MDC值是否能被正常捕获：

logger.info("MDC测试：ApigeeId={}, BasePath={}", MDC.get("ApigeeId"), MDC.get("BasePath"));

如果这条日志能正常显示值，说明问题出在后续异步/第三方组件的线程上下文传递上。

4. 确认Logback配置生效 #

• 检查logback.xml是否放在类路径根目录（如src/main/resources/）
• 排查是否存在logback-test.xml等其他配置文件覆盖当前配置
• 启动时添加-Dlogback.debug=true参数，查看Logback加载日志，确认配置是否被正确解析

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