函数式接口本身不承载 TraceContext，而是作为可包装的逻辑单元，配合 Sleuth 的 Tracing.currentTraceContext().wrap() 在异步、线程池等场景中安全传递上下文。
Java 中函数式接口本身不直接承载 TraceContext，但它可以作为跨线程上下文传递的桥梁工具，配合 Sleuth 的 Tracer 和 CurrentTraceContext，在异步、线程池、CompletableFuture 等场景中安全延续追踪上下文。
关键不是“用函数式接口存 TraceContext”，而是用它包装逻辑，再由 Sleuth 提供的装饰器（如 Tracing.currentTraceContext().wrap()）增强执行行为，从而自动注入和传播 TraceId、SpanId。
✅ 函数式接口如何参与 TraceContext 跨线程传递
Sleuth 默认使用 CurrentTraceContext（基于 ThreadLocal）管理当前 span。但 ThreadLocal 不会自动跨线程继承 —— 这正是函数式接口能起作用的地方：它把业务逻辑抽象为 Runnable、Supplier<T>、Function<I, O> 等可被“包装”的单元，Sleuth 可对其做上下文绑定。
常见方式：
立即学习“Java免费学习笔记（深入）”；
- 使用
Tracing.currentTraceContext().wrap(Runnable)包装Runnable - 使用
Tracing.currentTraceContext().wrap(Supplier<T>)包装Supplier - 在
CompletableFuture中，用executor.wrap()或supplyAsync(supplier, executor)配合 sleuth-aware 执行器
例如：
@Autowired Tracing tracing;
// 原始函数式逻辑（无上下文）
Runnable task = () -> {
log.info("处理订单"); // 此处日志不会带 traceId（若在新线程）
};
// Sleuth 包装后，自动携带当前 trace context
Runnable wrapped = tracing.currentTraceContext().wrap(task);
executor.submit(wrapped); // 新线程中 MDC 仍含 traceId/spanId✅ 为什么需要函数式接口？—— 它解决了什么问题
| 场景 | 问题 | 函数式接口 + Sleuth 的解法 |
|---|---|---|
new Thread(() -> {...}).start() |
ThreadLocal 断链，trace 丢失 |
把 () -> {...} 当作 Runnable，用 wrap() 封装 |
CompletableFuture.supplyAsync(() -> doWork()) |
异步线程无上下文 | 改为 supplyAsync(() -> doWork(), tracing.currentTraceContext().executor(executor))
|
| 自定义线程池提交任务 | 普通 submit(Runnable) 不传 context |
用 tracing.currentTraceContext().wrap(runnable) 包装后再 submit |
本质是：函数式接口提供了一种可延迟执行、可装饰、可组合的逻辑单元，让 Sleuth 能在其执行前注入上下文快照。
✅ 实际配置与注意事项
- Sleuth 2.x+（Spring Boot 2.4+）已内置对
ExecutorService、ScheduledExecutorService、ForkJoinPool的自动增强（需开启spring.sleuth.async.enabled=true） - 若手动管理线程池，推荐用
Tracing.currentTraceContext().executor(originalExecutor)获取增强版执行器 -
MDC日志集成依赖currentTraceContext()的实现，默认是DefaultCurrentTraceContext，它会将TraceContext快照复制到新线程的MDC中 - 不要自己用
MDC.getCopyOfContextMap()手动传递 —— Sleuth 的wrap()已封装该逻辑，更安全可靠
✅ 一个完整示例（CompletableFuture + Supplier）
@GetMapping("/order")
public String createOrder() {
Span current = tracer.currentSpan();
log.info("入口请求：{}", current.context().traceId());
return CompletableFuture
.supplyAsync(() -> {
log.info("异步校验库存"); // 自动带 traceId
return "success";
}, tracing.currentTraceContext().executor(Executors.newFixedThreadPool(2)))
.thenApply(result -> {
log.info("后续处理：{}", result); // 上下文仍延续
return result.toUpperCase();
})
.join();
}只要 tracing.currentTraceContext().executor(...) 返回的执行器被使用，所有 supplyAsync、thenApply 等回调都会继承原始 trace context。
函数式接口不是容器，而是适配器。它让 Sleuth 的上下文传播机制有了可插拔的切入点。真正起作用的是 CurrentTraceContext.wrap() 对函数式对象的增强，而非接口本身存储数据。
