ThreadLocal 泄漏与上下文污染
ThreadLocal 把值关联到当前线程，适合在线程边界稳定时保存少量调用上下文。在线程池中，线程会跨任务复用；忘记清理不仅会延长对象生命周期，还可能让下一次请求读到上一次请求的数据。
1. 值保存在 Thread 自己的映射中
private static final ThreadLocal<RequestContext> CONTEXT =
new ThreadLocal<>();
每个 Thread 可以持有自己的 ThreadLocalMap。ThreadLocal 对象用于在这张 map 中定位当前线程的值，所以并不是一个 ThreadLocal 实例内部保存“所有线程的值”。
隔离的是引用槽位。如果不同线程把同一个可变对象放进去，那个对象仍然共享，ThreadLocal 不会自动让它线程安全。
2. 弱 key 不能自动回收 value
map entry 对 ThreadLocal key 使用弱引用，但 value 仍是强引用。外部不再持有 ThreadLocal 后，key 可能被回收并变成 null，value 仍由长期存活线程的 map 引用，直到后续清理或线程结束。
线程池 Worker 可能与进程一样长寿，因此大对象、类加载器或请求对象会被意外保留。map 会在部分操作中清理陈旧 entry，但不能把它当成确定的生命周期协议。
3. 使用范围必须由 finally 关闭
CONTEXT.set(context);
try {
handleRequest();
} finally {
CONTEXT.remove();
}
remove() 比设置为 null 更明确，会删除当前线程的 entry。清理应和设置处位于同一作用域，覆盖正常返回和异常。
上下文污染比内存泄漏更直接：Worker 执行下一条请求时，若新请求没有成功设置上下文，就可能读取旧用户身份、租户或 trace 信息。
4. 跨线程执行不会自动得到期望上下文
任务提交到已有线程池后，Worker 不是请求线程，普通 ThreadLocal 不会传播。InheritableThreadLocal 在线程创建时复制初始值，而线程池 Worker 往往早已创建，所以也不能可靠地按任务传播。
可以在任务包装器中显式捕获必要的不可变上下文，在 Worker 开始时设置、结束时恢复或清理；日志框架和可观测性库通常提供自己的传播机制。传播范围要最小化，不要把整个请求对象复制到后台任务。
5. 虚拟线程改变了复用假设
每任务一个虚拟线程可以减少池化 Worker 的跨任务污染，因为线程结束后局部状态一起失去作用域。但数百万虚拟线程各自保存昂贵 ThreadLocal 会造成显著内存开销。
当前 JDK 的 Scoped Values 适合在线程及其受控子任务中共享不可变上下文，并通过词法作用域自动恢复。选择前仍要确认框架和目标 JDK 版本；可变缓存或外部资源不应因此塞进上下文。
6. 诊断保留与污染
- 堆转储中按
ThreadLocalMap$Entry、Worker 线程和可疑 value 查引用链。 - 在线程池任务边界记录上下文是否已残留，但避免输出敏感值。
- 对测试连续复用同一 Worker，验证异常路径后上下文为空。
- 监控线程数和每任务内存，区分 ThreadLocal 保留与普通缓存增长。
7. 常见问题
7.1 ThreadLocal 的 key 为什么设计为弱引用
它允许没有其他强引用的 ThreadLocal key 被回收，降低永久失去 key 的风险。但 value 的清理仍依赖 map 操作或线程结束，所以调用方仍必须 remove()。
7.2 ThreadLocal 能用来存数据库连接吗
除非事务框架严格管理获取、绑定和释放，否则不建议。隐藏资源生命周期会造成连接泄漏、事务串扰，也难以适配异步和虚拟线程。
8. 面试题
8.1 ThreadLocal 为什么可能发生内存泄漏，怎样避免
出现公司：美团、某云原生企业
考察重点
- ThreadLocalMap 的弱 key 与强 value。
- 线程池长生命周期和上下文污染。
finally中remove与显式传播。
相关内容：第 1 节“值保存在 Thread 自己的映射中”至第 4 节“跨线程执行不会自动得到期望上下文”。
参考回答
值实际保存在 Thread 的 ThreadLocalMap 中，entry 的 key 是 ThreadLocal 弱引用，value 仍是强引用。key 被回收后，长期存活的线程仍可能通过陈旧 entry 保留 value；线程池还可能让下一任务读到旧上下文。
设置和清理必须放在同一作用域，在 finally 调用 remove()。跨线程任务要只捕获必要的不可变上下文，在执行边界设置并恢复，不能依赖 InheritableThreadLocal 对已有 Worker 自动传播。