FutureTask 用作可观测性锚点，需快照固化链路上下文、重写 done() 监听生命周期、透传并清理 MDC，统一异常归因，避免上下文污染。
在自研分布式链路追踪插件中，用 FutureTask 捕获异步埋点块，核心不是“让它执行”，而是“让它成为可观测性的锚点”——即把一次异步操作的生命周期（提交、执行、完成、异常、取消）与链路上下文（如 traceId、spanId、线程本地变量）强绑定，从而实现精准归属。
确保异步任务携带完整链路上下文
FutureTask 本身不自动传递 MDC 或 ThreadLocal 中的链路信息，因为子线程会丢失父线程上下文。必须显式透传：
- 在构造
FutureTask前，从当前线程提取traceId、spanId、parentId等关键字段，封装进一个轻量上下文对象（如TraceContextSnapshot） - 将该快照作为闭包变量或构造参数传入
Callable实现中；FutureTask执行时，在call()开头立即用该快照重置子线程的 MDC 或注册到Tracer当前 span - 避免直接捕获外部
ThreadLocal变量（final 限制 + 线程切换后为空），必须做快照固化
利用 FutureTask 状态机监听关键生命周期事件
FutureTask 内部有明确状态流转（NEW → COMPLETING → NORMAL/CANCELLED/EXCEPTIONAL），但不提供回调钩子。可借助以下方式注入可观测逻辑：
- 重写
done()方法（FutureTask提供的受保护方法）：它在任务完成（无论成功、异常或取消）后被调用，且由执行线程（即 worker 线程）触发，此时上下文已恢复，适合记录结束 span、上报耗时、清理资源 - 在
done()中调用super.done()后，主动获取结果（outcome字段需反射访问，或通过isDone()/isCancelled()判断状态后安全调用getNow(null)） - 结合
get()调用时机做“被动埋点”：若业务方同步等待（如future.get(5, TimeUnit.SECONDS)），可在 catch 块中记录超时、中断或异常，补充链路中的 error 标记
统一异常归因与错误传播路径
异步埋点若抛出异常却未被感知，会导致链路断连或错误丢失：
- 所有
ExecutionException的getCause()必须提取原始异常，并标记为 span 的error属性；注意过滤掉InterruptedException（属控制流，非业务错误） - 对
CancellationException单独处理：区分是主动 cancel（如超时熔断）还是被动中断（如线程池 shutdown），前者可标记为status.code = STATUS_CANCELLED，后者建议记录 WARN 日志并关联 traceId - 禁止在
Callable.call()中吞掉异常；若需兜底，也应通过Tracer.activeSpan().tag("fallback", "true")显式标注
规避常见陷阱：线程复用与上下文污染
线程池复用线程时，MDC 不会自动清空，易导致后续任务继承前序 traceId：
- 在
done()结尾或call()返回前，强制清除当前线程的 MDC（MDC.clear()）或调用Tracer.close() - 若使用
ExecutorService.submit(Runnable)包装FutureTask，注意Runnable的run()不返回值，无法捕获异常结果；优先用submit(Callable)直接构造FutureTask - 避免将
FutureTask实例长期缓存或跨请求复用——每个异步操作应有独立实例，保障上下文隔离
