ThreadLocal 隔离用户会话需确保线程独享、及时清理、跨线程显式传递：请求入口初始化，收尾钩子 remove() 防内存泄漏；子线程需手动拷贝上下文；Spring 中推荐结合 RequestScope 或 TaskDecorator 统一管理。
用 ThreadLocal 隔离多线程的用户会话上下文，核心是让每个线程拥有独立副本，避免共享变量引发的数据错乱。关键不在“存”，而在“何时存、谁来清理、如何传递”。
初始化时绑定用户上下文
在请求入口（如过滤器、拦截器或 WebMvcConfigurer 的 preHandle）中，从请求头、Token 或 Session 提取用户 ID、租户、权限等信息，封装为上下文对象，存入当前线程的 ThreadLocal：
- 推荐使用静态内部类 +
initialValue()避免 null 引用，例如：
private static final ThreadLocalCONTEXT_HOLDER = ThreadLocal.withInitial(UserContext::new); - 不要在构造方法里直接 new，而应通过
set()显式赋值，确保每次请求都覆盖旧值； - 若上下文需继承（如子线程访问），改用
InheritableThreadLocal，但注意它不支持线程池复用场景。
避免内存泄漏：务必在线程结束前清理
ThreadLocal 的 key 是弱引用，value 却是强引用——线程复用（如 Tomcat 线程池、自定义线程池）时，若不手动 remove()，value 会长期滞留，造成内存泄漏。
- 在请求生命周期末尾（如 Filter 的
doFilter()后、Interceptor 的afterCompletion()）调用CONTEXT_HOLDER.remove()； - 不要依赖
finally块做清理（可能被异常跳过），优先放在明确的收尾钩子中； - 若使用 Spring AOP，可在 @AfterReturning/@AfterThrowing 中统一清理。
跨线程传递需显式拷贝
普通线程池（如 ThreadPoolExecutor）不会自动继承父线程的 ThreadLocal 值，必须手动透传：
立即学习“Java免费学习笔记（深入）”；
- 包装
Runnable或Callable，在提交前捕获当前上下文，在子线程执行前set()，执行后remove()； - Spring 已提供
ThreadPoolTaskExecutor的setTaskDecorator方法，可统一注入上下文复制逻辑； - 慎用
ForkJoinPool，其工作窃取机制会使上下文传递更复杂，建议改用普通线程池或异步编排（如CompletableFuture.supplyAsync(() -> ..., executor)并手动传参）。
结合 Spring 的最佳实践
在 Spring Web 环境中，可借助框架能力降低出错概率：
- 将
ThreadLocal封装为@Scope("prototype")Bean，配合@Autowired注入，由 Spring 管理生命周期； - 用
@RequestScope替代部分场景（仅限 HTTP 请求内），但注意它无法用于异步线程或非 Web 环境； - 配合 MDC（Mapped Diagnostic Context）记录日志上下文，让日志天然携带 traceId、userId，便于排查问题。
