如何应用自定义线程工厂为线程池注入业务上下文实战提升变量日志的追踪维度-java教程-PHP中文网

默认线程工厂无法传递业务上下文，因其创建的线程不继承父线程mdc（基于threadlocal），导致异步日志traceid丢失；需通过runnable装饰器或自定义threadfactory配合mdc快照与清理来保障上下文准确传递。

如何应用自定义线程工厂为线程池注入业务上下文实战提升变量日志的追踪维度

直接在任务执行前捕获上下文、在线程创建时注入、并在执行后清理，是保障日志追踪维度不丢失的核心动作。单靠线程工厂只能解决“首次创建”时的上下文快照，无法应对线程复用带来的污染问题，必须配合 Runnable 装饰器或 MDC 手动管理策略。

为什么默认线程工厂做不到业务上下文传递

ExecutorService 默认使用的 Executors.defaultThreadFactory() 创建的线程是“干净”的：不继承父线程的 MDC（Mapped Diagnostic Context），也不携带任何业务 ID（如 traceId、tenantId、userId）。因为 MDC 底层依赖 ThreadLocal，而子线程不会自动复制父线程的 ThreadLocal 值——即使你在提交任务前调用了 MDC.put("traceId", "abc123")，池中线程执行时仍读不到它。结果就是异步日志里 traceId 为空，链路断裂，排查困难。

自定义 ThreadFactory 的正确写法（仅作基础快照）

它适合在新线程诞生瞬间做一次上下文“冻结”，但不能替代任务级隔离。关键点是深拷贝而非引用：

使用 MDC.getCopyOfContextMap() 获取当前上下文副本，避免后续父线程修改影响
在 newThread() 中新建线程后，立即通过 MDC.setContextMap(...) 绑定到该线程
为防止异常中断导致清理遗漏，建议在线程的 UncaughtExceptionHandler 中也补一次 set + clear

示例片段：

ThreadFactory factory = r -> {
  Thread t = new Thread(r);
  Map parentMdc = MDC.getCopyOfContextMap();
  t.setUncaughtExceptionHandler((th, ex) -> {
    if (parentMdc != null) MDC.setContextMap(parentMdc);
    log.error("Uncaught in {}", th.getName(), ex);
    MDC.clear();
  });
  return t;
};