Spring Boot异步调用时RequestContextHolder获取请求上下文为空的解决办法

问题核心在于：RequestContextHolder默认通过ThreadLocal存储请求上下文，异步调用会创建新线程，新线程无法继承原线程的ThreadLocal数据，导致getAttributes()返回null。以下是几种可行的解决方式：

方法一：手动传递并设置RequestAttributes #

在启动异步任务前，先获取原线程的请求上下文，再在异步线程中手动注入，执行完成后清理上下文避免内存泄漏。

代码示例：

// 原线程中获取当前请求上下文
RequestAttributes attributes = RequestContextHolder.getRequestAttributes();

CompletableFuture.supplyAsync(() -> {
    try {
        // 异步线程中注入上下文
        RequestContextHolder.setRequestAttributes(attributes);
        return dependentService.getSomething();
    } finally {
        // 执行完毕后重置上下文，防止线程复用导致的上下文混乱
        RequestContextHolder.resetRequestAttributes();
    }
});

方法二：配置自定义异步线程池自动继承上下文 #

通过自定义AsyncTaskExecutor，设置任务装饰器，让所有异步线程自动继承原线程的请求上下文，无需每次手动传递。

1. 创建线程池配置类

@Configuration
@EnableAsync
public class AsyncConfig implements AsyncConfigurer {

    @Override
    public Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(5);
        executor.setMaxPoolSize(10);
        executor.setQueueCapacity(25);
        executor.setThreadNamePrefix("Async-Task-");
        
        // 核心：通过任务装饰器实现上下文继承
        executor.setTaskDecorator(runnable -> {
            RequestAttributes attributes = RequestContextHolder.getRequestAttributes();
            return () -> {
                try {
                    RequestContextHolder.setRequestAttributes(attributes);
                    runnable.run();
                } finally {
                    RequestContextHolder.resetRequestAttributes();
                }
            };
        });
        executor.initialize();
        return executor;
    }
}

2. 使用自定义线程池执行异步任务
   可以直接在@Async注解中指定该线程池（若配置为默认则无需指定），或者手动传入supplyAsync：

@Autowired
private Executor asyncExecutor;

// 调用时使用自定义线程池
CompletableFuture.supplyAsync(() -> dependentService.getSomething(), asyncExecutor);

方法三：使用Spring @Async注解简化操作 #

如果业务场景允许，直接使用Spring的@Async注解标记异步方法，配合上述自定义线程池，Spring会自动完成上下文的传递，无需手动处理：

@Async
public CompletableFuture<String> fetchDependentData() {
    return CompletableFuture.completedFuture(dependentService.getSomething());
}

注意事项 #

• 所有异步任务执行完毕后必须重置RequestContextHolder，否则线程池复用线程时会携带旧的请求上下文，引发数据混乱或内存泄漏。
• 若使用CompletableFuture的链式调用（如thenApply），后续回调线程也需要重新设置上下文，或者确保整个异步流程都在注入了上下文的线程中执行。

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