childValue 是透传 TraceID 的关键入口，因其允许主动控制子线程值派生逻辑，弥补 InheritableThreadLocal 在线程复用场景（如线程池、CompletableFuture）下默认继承失效的问题。
为什么 childValue 是透传 TraceID 的关键入口
InheritableThreadLocal 默认只在子线程创建时浅拷贝父线程的值，但像 CompletableFuture、线程池提交任务、或 Netty EventLoop 这类场景，线程复用频繁，子线程并非“刚 new 出来”，默认继承机制就失效了。而 childValue 是一个受保护方法，允许你**主动控制每次派生新值的逻辑**——比如把父线程的 TraceID 原样复制，或生成带父子关系的新 ID（如 traceId-spanId）。
它不是自动触发的魔法，而是在线程初始化时被 InheritableThreadLocal#createInheritedMap 调用，仅对真正继承的场景生效（即 new Thread() 或 ForkJoinWorkerThread 启动）。所以必须配合自定义线程工厂或包装执行器，才能覆盖异步调用链。
如何重写 childValue 实现 TraceID 透传
核心是让子线程拿到的不是 null，而是可延续的上下文。常见做法是直接返回原值，或做轻量封装：
private static final InheritableThreadLocal<string> TRACE_ID_HOLDER = new InheritableThreadLocal() {
@Override
protected String childValue(String parentValue) {
// 直接透传：适合简单日志链路
return parentValue;
// 或生成新 spanId：return parentValue != null ? parentValue + "-" + UUID.randomUUID().toString().substring(0, 8) : null;
}
};
</string>
注意三点：
-
childValue的参数parentValue是父线程当前get()的结果，不是历史快照；若父线程已remove()，这里就是null - 返回
null是合法的，但下游若不做空判断，容易 NPE；建议统一返回空字符串或占位符（如"MISSING"） - 不要在
childValue中调用ThreadLocal.set()或触发任何副作用——它只负责“派生值”，不负责存储
线程池场景下 childValue 为何经常不生效
ThreadPoolExecutor 复用线程，新任务提交时不会触发 InheritableThreadLocal 的继承逻辑，因为线程早已存在。此时 childValue 根本不会被调用。
解决办法不是放弃 childValue，而是把它作为“兜底”机制，并在任务提交前手动注入：
- 用
ThreadLocal包装任务（如Runnable或Supplier），在执行前set()当前TRACE_ID_HOLDER.get() - 使用装饰器模式包装
ExecutorService，在submit()和execute()中捕获并传递上下文 - Spring 用户可结合
TaskDecorator，在decorate方法里完成TRACE_ID_HOLDER.set(parentValue)
也就是说：childValue 只管“继承”，不管“复用”；异步链路中大部分透传实际靠的是“显式搬运”。
和 TransmittableThreadLocal 对比时容易忽略的细节
阿里开源的 TransmittableThreadLocal（TTL）确实更省心，但它底层仍是靠 childValue + 静态注册 + beforeExecute/afterExecute 钩子实现的。如果你自己实现，要注意：
它不能替代线程局部变量的生命周期管理——比如你在子线程里 remove() 了，父线程的值不会受影响，但下次该线程再被复用时，若没重新 set，就会拿到上次遗留的旧值（除非你每次执行都清理）。
- TTL 的
copy方法本质就是你手写的childValue，只是暴露成了 public - 如果用了
logback MDC配合 TraceID，记得在childValue返回后立即同步到MDC.put("traceId", value)，否则日志里还是空 - Android 或某些受限环境不支持
sun.misc.Unsafe，TTL 会退化为反射方案，性能下降明显；而原生InheritableThreadLocal更轻量、兼容性更好
childValue，而是识别出哪些异步路径走的是“真继承”（如 ForkJoinPool）、哪些走的是“假复用”（如 Tomcat 线程池），然后分别应对。漏掉任意一类，TraceID 就会在某个环节断掉。
