异步线程池日志 traceId 100% 为 null:MDC 透传怎么补

查一个下单超时的工单,按 traceId 去日志平台捞,同步段七条日志都在,进入线程池之后只剩时间戳,traceId 那一列全是 null。

埋点方式是 logback 的 %X{traceId},入口在 Filter 里 MDC.put。同步调用没问题,一旦交给 @ASYNc 或者自己 new 的 ThreadPoolExecutor,MDC 就断了。

原因不复杂,MDC 底层是 ThreadLocal,值跟着线程走。提交任务只是把 Runnable 放进队列,真正执行它的是池里的另一个线程,那个线程的 MDC 是空的。线程池还会复用,上一个任务的上下文如果没清,会串到下一个任务上。

第一版改法是在每个异步方法开头手动 MDC.put,末尾 remove。改到第 11 个类就放弃了,漏一处断一条链路,新加的异步任务也没人记得写。

第二版试了 InheritableThreadLocal 的思路,以为子线程能继承父线程的 MDC。单次 new Thread 确实可以,线程池不行:池里的线程是复用的,继承只发生在创建那一刻,之后所有任务共用第一个请求的 traceId。上线半天,日志里出现 A 订单的 traceId 挂在 B 订单上,比 null 更难查。

最后用 TaskDecorator。Spring 的 ThreadPoolTaskExecutor 支持装饰器,提交时把当前线程的 MDC 快照拷一份,执行时设进去,结束时清掉。

public class MdcDecorator implements TaskDecorator {
  public Runnable decorate(Runnable r) {
    Map<String, String> ctx = MDC.getCopyOfContextMap();
    return () -> {
      if (ctx != null) MDC.setContextMap(ctx);
      try { r.run(); } finally { MDC.clear(); }
    };
  }
}

清空这一步不能省。用 setContextMap 覆盖也行,但任务抛异常时还有一层外层包装,MDC.clear 最稳。

还有两个漏网的地方。CompletableFuture.supplyAsync 不传 executor 时用的是 ForkJoinPool,装饰器管不到,得显式传自己的线程池;定时任务和 MQ 消费线程的上下文来自消息头,要在消费入口重新 put,不能指望生产端的 MDC 自己传过来。

确认方式:压测 20 个线程跑 5000 单,日志里 traceId 为 null 的比例从 38% 降到 0;随便抽 20 个 traceId,每个都能串起网关、订单、库存、支付四个服务的日志。

您可以还会对下面的文章感兴趣: