如何在CompletableFuture.runAsync中获取RequestContextHolder.getRequestAttributes()

RequestContextHolder底层基于ThreadLocal实现，请求属性只会绑定到处理当前请求的容器线程上。CompletableFuture.runAsync默认使用公共ForkJoinPool的独立线程执行任务，和原请求线程不属于同一个线程上下文，因此默认无法获取到请求属性，就会抛出对应的报错。

方案1：手动传递请求上下文（单次使用，无需全局配置） #

在启动异步任务前，先从原线程取出RequestAttributes，传入异步任务内部后再绑定到子线程的上下文，任务结束后记得清理避免内存泄漏。

// 原请求线程中提前获取上下文
RequestAttributes requestAttributes = RequestContextHolder.getRequestAttributes();
CompletableFuture.runAsync(() -> {
    try {
        // 给子线程绑定上下文
        RequestContextHolder.setRequestAttributes(requestAttributes);
        // 这里就能正常调用RequestContextHolder.getRequestAttributes()执行业务逻辑
    } finally {
        // 任务执行完清除上下文，避免线程复用导致上下文串用
        RequestContextHolder.resetRequestAttributes();
    }
});

如果异步任务执行时长超过请求本身的生命周期，容器会回收请求相关对象，可能出现属性失效，建议如果只需要请求里的特定参数，直接提前取出参数值传入异步任务，比传递整个RequestAttributes更稳妥。

方案2：全局配置线程池装饰器（适合大量异步场景，避免重复写传递逻辑） #

自定义TaskDecorator实现上下文自动传递，再把装饰器配置到项目用的异步线程池中，后续所有用这个线程池的异步任务都会自动带上请求上下文。

1. 编写上下文传递装饰器

public class ContextCopyingDecorator implements TaskDecorator {
    @Override
    public Runnable decorate(Runnable runnable) {
        // 原线程提前取上下文
        RequestAttributes context = RequestContextHolder.getRequestAttributes();
        return () -> {
            try {
                // 子线程设置上下文
                RequestContextHolder.setRequestAttributes(context);
                runnable.run();
            } finally {
                // 清理上下文
                RequestContextHolder.resetRequestAttributes();
            }
        };
    }
}

2. 配置绑定了装饰器的异步线程池

@Configuration
public class AsyncThreadPoolConfig {
    @Bean
    public Executor asyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(10);
        executor.setMaxPoolSize(50);
        executor.setQueueCapacity(100);
        // 绑定自定义装饰器
        executor.setTaskDecorator(new ContextCopyingDecorator());
        executor.initialize();
        return executor;
    }
}

3. 使用时指定自定义线程池即可

CompletableFuture.runAsync(() -> {
    // 这里直接就能获取到请求属性执行业务逻辑
}, asyncExecutor);

• 不要在异步任务中直接操作HttpServletRequest/HttpServletResponse对象，这两个对象本身不是线程安全的，且请求结束后会被容器回收复用，容易出现异常。
• 如果异步任务执行时间远长于请求处理时间，建议提前抽取需要的请求参数值传递，不要依赖RequestContextHolder的生命周期，避免出现属性失效、内存泄漏问题。

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