spring @async上下文丢失的根源是threadlocal变量无法自动跨线程传递，正确做法是捕获→包装→还原，而非反射解析参数；requestcontextholder需显式透传关键属性。

这个问题其实不在于“反射抓错线程栈”，而是对异步上下文传递机制的常见误解——根本不存在“反射提取注解参数用于上下文传递”这回事。Spring 的 @Async 并不靠反射读取方法参数来决定怎么传 MDC、TraceID 或用户信息；它只做一件事：把被代理的方法封装成 Runnable/Callable，再扔进线程池执行。

上下文丢失和“脱轨”的真实原因

所谓“脱轨”，本质是以下两个环节断开：

• 主线程中已通过拦截器或 Filter 设置了 MDC（如 traceId）、SecurityContext、RequestContextHolder 等，但这些 ThreadLocal 变量不会自动进入线程池里的复用线程
• 你没在任务提交前主动捕获、也没在子线程执行前主动还原，导致日志打不出 traceId、权限校验拿不到当前用户、事务上下文为空

别碰反射解析参数这条歪路

试图通过反射去扫描 @Async 方法的参数类型、再手动塞值回子线程，既不可靠又高危：

• 参数可能是复杂对象、泛型、甚至 null，无法安全反推上下文含义
• Spring AOP 代理后的方法签名可能被增强（比如 CGLIB 生成的 $$_EnhancerBySpringCGLIB），反射获取的 Parameter 不稳定
• 一旦方法重载、默认参数、Optional 包装等情况出现，逻辑立刻失效

正确做法：专注上下文快照与还原

所有需要跨线程延续的信息，统一走「捕获 → 包装 → 还原」三步，与方法签名完全解耦：

• 在 Web 拦截器中完成 MDC.put("traceId", xxx) 和 SecurityContextHolder.getContext().setAuthentication(xxx)
• 提交异步任务前，用 TransmittableThreadLocal.copy() 或 MDC.getCopyOfContextMap() 快照当前状态
• 用 TtlRunnable.wrap(runnable) 或自定义 ContextAwareRunnable 包装任务，在 run() 开头 replay，结尾 clear
• 若用 @Async，直接继承 ThreadPoolTaskExecutor 并重写 submit/execute，内部自动包装，业务代码零修改

特别注意 RequestContextHolder 的陷阱

Spring 默认的 RequestContextHolder 使用的是 RequestAttributes + ThreadLocal，且 scope 是 REQUEST，它在线程池里天然失效。解决方式不是去反射找参数，而是：

• 改用 RequestContextHolder.setRequestAttributes(requestAttrs, true) 的第二个参数设为 true，启用 inheritable 模式（仅限新线程创建时有效，仍不适用于线程池）
• 更稳妥的是：在拦截器中把关键 request 属性（如 userId、tenantId）显式写入 MDC 或 TransmittableThreadLocal，然后统一透传