threadlocal无法跨线程传递数据，因各线程threadlocalmap独立且子线程不继承父线程值；inheritablethreadlocal仅支持new thread()，对线程池、completablefuture等无效；正确做法是封装tracecontext实现capture/replay显式透传，并优先集成opentelemetry等成熟方案。
ThreadLocal 本身不能跨线程传递数据，它只在当前线程内有效。要在多线程日志追踪系统中实现全链路标识（如 traceId）的“跨线程传递”，必须配合显式透传机制——不是靠 ThreadLocal 自动传播，而是手动把标识从父线程复制到子线程的 ThreadLocal 中。
为什么 ThreadLocal 无法自动跨线程
每个线程都有独立的 ThreadLocalMap，子线程初始化时其 ThreadLocalMap 是空的，不会继承父线程的值。哪怕使用 InheritableThreadLocal，也仅对 new Thread() 场景有限支持，对线程池、CompletableFuture、Dubbo/Feign 远程调用等主流异步场景完全失效。
正确做法：封装 TraceContext 工具类 + 显式透传
定义一个中心化上下文管理器，用 ThreadLocal 存储 traceId，并提供「捕获」和「重放」能力：
- 捕获（capture）：在进入异步边界前（如 submit、supplyAsync、runAsync 前），读取当前线程 traceId，封装成可序列化对象（如 Map 或自定义 ContextCarrier）
- 重放（replay）：在子线程执行逻辑前，将捕获的 traceId 写入子线程的 ThreadLocal
- 推荐封装为静态工具方法，例如：TraceContext.capture() 和 TraceContext.replay(carrier)
适配常见异步场景的写法示例
线程池提交任务：
Runnable task = () -> {
TraceContext.replay(capturedContext); // 关键：手动重放
doBusinessLogic();
};
executor.submit(task);
CompletableFuture 异步链：
CompletableFuture.supplyAsync(() -> {
String traceId = TraceContext.getTraceId(); // 捕获
return traceId;
}, executor)
.thenApplyAsync(traceId -> {
TraceContext.setTraceId(traceId); // 重放（或用 replay 封装）
return doRemoteCall();
}, executor);
Spring @Async 方法：需自定义 AsyncConfigurer，包装 TaskExecutor，在 execute() 中自动完成 capture → replay 流程（通过装饰器模式）。
进阶建议：对接 OpenTracing / OpenTelemetry 标准
不建议从零手写 traceId 透传逻辑。优先集成成熟方案：
- 使用 OpenTelemetry Java SDK：自动注入 MDC、支持线程池/CompletableFuture/Servlet/GRPC 等全场景上下文传播
- 若用 SkyWalking：直接依赖 apm-toolkit-trace，@Trace 注解 + TraceContext.traceId() 即可获取，底层已处理透传
- 自研系统务必覆盖线程池（ThreadPoolTaskExecutor）、响应式框架（Project Reactor 的 Context）、RPC 调用（Header 透传 + 拦截器）三类关键路径
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
