ThreadLocal是线程局部变量工具，解决单线程内跨方法数据共享问题而非并发竞争；底层每个Thread持有一个ThreadLocalMap，key为弱引用的ThreadLocal实例，value为线程私有副本，避免内存泄漏需主动remove()。
ThreadLocal 面试连环炮，核心不是背答案，而是讲清楚“为什么这样设计”“哪里容易踩坑”“怎么验证理解”。下面按真实高频追问顺序组织，帮你把逻辑链补全、把细节抠准、把反问接住。
ThreadLocal 是什么？它解决什么问题？
ThreadLocal 是线程本地变量，每个线程拥有自己独立的副本，互不干扰。它不解决共享变量的并发修改问题（那是 synchronized 或 CAS 的事），而是解决“单线程内需要跨方法传递、又不想层层传参”的场景。
典型用途：
- 数据库连接、事务上下文（如 Spring 的 TransactionSynchronizationManager）
- 用户身份、请求追踪 ID（如 MDC 日志上下文）
- SimpleDateFormat 等非线程安全对象的复用
⚠️注意：它不是“线程安全的 Map”，而是“每个线程一份 Map.Entry”，底层靠 Thread 内部的 ThreadLocalMap 维护。
ThreadLocal 底层怎么实现的？为什么 key 是弱引用？
每个 Thread 对象持有一个 ThreadLocalMap 成员变量，key 是 ThreadLocal 实例，value 是你 set 的值。这个 map 不是 java.util.HashMap，而是自定义的开放地址法哈希表，仅在当前线程内使用。
key 设计为弱引用（WeakReference
- 如果 key 是强引用，ThreadLocal 被外部置为 null 后，map 中仍持有它的强引用 → 无法被 GC → Entry 泄漏 → value 也一直存活（尤其 value 是大对象时）
- 弱引用 key 能让 ThreadLocal 被回收，但 Entry 还在（变成 key==null 的“脏 entry”），后续 get/set/resize 时会触发探测式清理
✅所以真正内存泄漏的主因是：线程长期运行（如线程池中的线程）+ 没调用 remove() + 有脏 entry 未被触发清理 → value 无法释放。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
ThreadLocal 有哪些经典陷阱？remove() 到底什么时候必须调用？
三个高频坑点：
- 线程复用导致数据串话：Tomcat 或线程池中，A 请求 set("userA")，B 请求没 clear 就 get()，可能拿到 userA —— 必须在请求结束前 remove()
- 忘记 remove() 引发内存泄漏：尤其 value 是 ArrayList、Connection 等大对象时，泄漏会随时间放大 —— 只要 ThreadLocal 用于线程池，就必须配套 remove()
- 父子线程不共享：子线程不会自动继承父线程的 ThreadLocal 值（InheritableThreadLocal 才支持）
✅最佳实践写法：
try {
threadLocal.set(value);
// 业务逻辑
} finally {
threadLocal.remove(); // 即使异常也要清理
}
ThreadLocal 和 InheritableThreadLocal 有什么区别？
InheritableThreadLocal 继承自 ThreadLocal，重写了 childValue() 方法，在 new Thread() 创建子线程时，会把父线程的 inheritableThreadLocals 复制一份给子线程（浅拷贝）。
注意点：
- ForkJoinPool、线程池 submit() 的 Runnable 不走普通 new Thread 流程，不会触发继承
- 异步框架（如 CompletableFuture）默认也不继承，需手动 withExecutor 或显式传值
- value 是浅拷贝，若 value 本身可变（如 HashMap），父子线程仍可能操作同一对象 → 线程安全风险仍在
✅替代方案更可控：显式封装上下文对象，通过参数或装饰器传递，避免隐式继承带来的不确定性。
把这几层逻辑串起来讲——从需求出发（为什么需要）、到机制（怎么实现）、再到边界（什么情况下失效/出错）、最后是工程对策（怎么写才健壮）——面试官基本不会再深挖。关键是你能不能一边说一边画出 Thread → ThreadLocalMap → Entry 的关系，把“弱引用+探测清理”这个设计意图说明白。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
