ThreadLocal无法解决Feign上下文丢失问题，因其不跨线程传递；正确做法是通过RequestInterceptor将租户ID等注入请求头，并在下游Filter中解析重建上下文，异步场景需结合TransmittableThreadLocal和TtlExecutors。
ThreadLocal 本身不能解决 Feign 调用的上下文丢失问题——它恰恰是问题的根源。Feign 默认使用独立线程池（如 OkHttp 或 HttpClient 的工作线程）发起远程调用，而 ThreadLocal 数据**不会自动跨线程传递**，主线程中存入的租户 ID、用户信息、TraceId 等在 Feign 线程里全部为 null。
为什么 ThreadLocal 在 Feign 中必然失效
根本原因有两点：
- Feign 执行 HTTP 请求时，不复用当前 Web 请求线程，而是交由底层客户端（如 Apache HttpClient 或 OkHttp）的线程池处理，新线程没有继承原线程的 ThreadLocal 值
- InheritableThreadLocal 也无效：它仅在 子线程创建瞬间 复制父线程值，而线程池中的线程是预创建、反复复用的，不会每次调用都新建线程
正确做法：不依赖 ThreadLocal 传递，改用显式透传
核心思路是「把上下文从内存变量转成 HTTP 协议的一部分」：
-
调用方：通过 Feign
RequestInterceptor将关键上下文（如X-Tenant-ID、X-Trace-ID、X-User-ID）注入请求头 -
被调方：在入口 Filter（如
OncePerRequestFilter）中解析请求头，并重新绑定到本地 ThreadLocal 或 MDC 中 - 确保 Filter 执行顺序优先于所有业务逻辑（例如加
@Order(Ordered.HIGHEST_PRECEDENCE)）
进阶加固：应对异步与线程池场景
如果服务内部还涉及异步任务（如 @Async、自定义线程池），单靠 Header 透传仍不够。此时需引入 TransmittableThreadLocal（TTL）：
- 将租户、用户、TraceId 等上下文封装为 TTL 实例（替代普通 ThreadLocal）
- 线程池必须包装为
TtlExecutors，确保任务提交时自动捕获并传递上下文 - Feign 拦截器中读取 TTL 值（而非原始 ThreadLocal），避免取空
配套建议：避免常见陷阱
落地时注意几个关键细节：
- Feign 客户端若启用 Hystrix（THREAD 隔离模式），同样会切断 ThreadLocal —— 此时必须配合 TTL 或改用 SEMAPHORE 模式
- 下游服务解析 Header 后，务必在 finally 块或 try-with-resources 中调用
clear()，防止线程复用导致上下文残留 - 不要在 Feign 拦截器里直接调用
RequestContextHolder.getRequestAttributes()：异步或 Hystrix THREAD 模式下该值为 null
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
