Spring Boot 3响应式应用中MDC上下文无法写入日志求助

可能的原因及对应解决方案 #

1. 日志配置未引用MDC字段 #

日志框架（如Logback/Log4j2）的配置文件里，PatternLayout必须明确指定要输出的MDC键。如果配置中没有包含%X{mdc}（或自定义的键名），即使MDC中有值，日志也不会输出该内容。

检查点：

• 打开logback.xml或log4j2.xml，确认日志格式中包含%X{mdc}，例如：

  <encoder>
    <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg %X{mdc}%n</pattern>
  </encoder>
  

2. contextWrite的调用顺序错误 #

在响应式流中，contextWrite的执行时机决定了上下文是否能被后续的日志操作获取到。如果contextWrite是在日志语句之后调用的，那么日志输出时MDC还未被填充。

正确用法：
确保contextWrite在所有需要MDC的操作之前执行：

return Mono.just("test-data")
           .contextWrite(ctx -> ctx.put("mdc", "request-123"))
           .doOnNext(data -> log.info("Processing data: {}", data));

3. MdcContextLifter的实现存在缺陷 #

从断点能看到上下文键经过lambda，但可能Lifter没有正确将Reactor Context中的值同步到当前线程的MDC中，或者没有处理线程切换的场景：

• 检查Lifter是否在onSubscribe、onNext等事件中，将Context中的"mdc"值放入MDC；
• 确认Lifter是否在操作完成后清理MDC（避免ThreadLocal泄漏）；
• Spring Boot 3适配的Reactor版本可能有API变动，需确保Lifter的实现符合当前Reactor的上下文传递机制。

示例修正方向：
在Lifter的onNext方法中显式设置MDC：

@Override
public void onNext(T t) {
    Context context = subscriberContext;
    String mdcValue = context.getOrDefault("mdc", "");
    MDC.put("mdc", mdcValue);
    try {
        actual.onNext(t);
    } finally {
        MDC.remove("mdc"); // 操作完成后清理
    }
}

4. 线程切换导致MDC丢失 #

MDC基于ThreadLocal实现，响应式流中线程切换时，MDC不会自动传递。如果Lifter仅在订阅阶段设置MDC，后续操作切换到其他线程时，MDC会丢失。

解决思路：
确保每个执行日志操作的线程都能从Reactor Context中重新获取并设置MDC。可以通过自定义Operator或使用Reactor的Context钩子，在每个线程执行任务前同步MDC。

5. 键名冲突或格式问题 #

检查是否存在以下情况：

• MDC键名大小写不一致（如代码中用"mdc"，日志配置中用"MDC"）；
• 其他组件（如过滤器、拦截器）覆盖了"mdc"键的值；
• 键名包含特殊字符，导致日志框架无法识别。

快速排查步骤 #

1. 验证日志配置：手动在日志语句前执行MDC.put("mdc", "test-value")，看日志是否输出该值，排除配置问题；
2. 确认上下文传递：在doOnNext中通过Mono.deferContextual获取上下文，打印"mdc"值：

   .deferContextual(ctx -> {
       log.info("Context mdc value: {}", ctx.get("mdc"));
       return Mono.just("data");
   })
   

3. 检查线程一致性：在MdcContextLifter中打印当前线程ID，和日志输出的线程ID对比，确认是否为同一线程；
4. 简化测试场景：写一个最小化的测试用例，去掉其他业务逻辑，仅保留contextWrite和日志输出，验证MDC是否正常工作。

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