Spring如何向子方法传递上下文信息？

针对多入口场景下的上下文传递需求，以下是几个成熟且低侵入的方案，无需大规模重构或自定义Spring作用域：

1. ThreadLocal + 入口初始化 + 异步上下文传递 #

这是业界最常用的方案，完全避免方法参数传递的繁琐：

• 核心实现：定义一个MyContextHolder类，用ThreadLocal存储上下文对象：

  public class MyContextHolder {
      private static final ThreadLocal<MyContext> CONTEXT_HOLDER = new ThreadLocal<>();
  
      public static MyContext getContext() {
          return CONTEXT_HOLDER.get();
      }
  
      public static void setContext(MyContext context) {
          CONTEXT_HOLDER.set(context);
      }
  
      public static void clearContext() {
          CONTEXT_HOLDER.remove();
      }
  }
  

• 入口处理：在所有入口的最开始初始化上下文：
  • REST接口：通过Filter或Interceptor从请求中提取信息（比如traceId、用户信息），调用MyContextHolder.setContext()；
  • 队列监听器：在消费消息前，从消息体/属性中提取上下文信息，完成初始化；
• 异步场景兼容：默认ThreadLocal不会传递到异步线程，针对不同异步方式处理：
  • 用Spring @Async：自定义TaskExecutor，在提交任务时复制当前线程的上下文到异步线程，任务结束后清理；
  • 用CompletableFuture：封装工具方法传递上下文，示例：

    public static <T> CompletableFuture<T> supplyAsyncWithContext(Supplier<T> supplier) {
        MyContext currentContext = MyContextHolder.getContext();
        return CompletableFuture.supplyAsync(() -> {
            MyContextHolder.setContext(currentContext);
            try {
                return supplier.get();
            } finally {
                MyContextHolder.clearContext();
            }
        });
    }
    

• 关键注意：必须在入口处理完成后调用MyContextHolder.clearContext()，避免线程复用导致的内存泄漏或上下文串扰。

2. 扩展Spring风格的上下文持有者 #

参考Spring RequestContextHolder的设计，实现自己的多入口兼容上下文管理：

• 本质和ThreadLocal方案一致，但可以结合Spring的扩展点（比如RequestAttributes），让HTTP场景下可以复用部分Spring的上下文逻辑；
• 非HTTP场景（队列、定时任务）则完全自定义初始化逻辑，服务层统一通过MyContextHolder获取上下文，无需区分入口类型。

3. 轻量级AOP兜底（可选） #

如果担心入口遗漏上下文初始化，可以用AOP做兜底：

• 给所有入口方法（比如@RestController的方法、队列监听方法）添加切面，自动完成上下文的初始化和清理；
• 给服务方法添加切面，检查上下文是否存在，避免无上下文的非法调用。

方案优势对比 #

• 对比「全量加context参数」：零服务方法改造，仅需在入口和异步工具类做少量开发，重构成本几乎为0；
• 对比「自定义Spring作用域」：基于JDK原生API，理解和维护成本极低，无需处理Spring作用域的生命周期、Bean代理等复杂逻辑。

内容的提问来源于stack exchange，提问作者zZz