ThreadLocal为每个线程提供独立变量副本，实现线程间数据隔离。其原理是线程内部维护ThreadLocalMap，key为ThreadLocal实例（弱引用），value为线程专属值；调用get()时从当前线程的map中获取对应值。常见应用场景包括：1. 用户上下文传递，避免层层参数传递，在Filter中存入信息后各层直接获取；2. 解决非线程安全工具类的共享问题，如为每个线程创建独立SimpleDateFormat实例；3. 事务管理中绑定数据库连接，确保同一事务使用同一Connection；4. 配合MDC实现日志追踪，通过ThreadLocal保存traceId以便链路排查。需注意内存泄漏风险：由于value为强引用，若未及时调用remove()，在线程池场景下可能导致旧值无法回收，因此使用后应主动清理。
ThreadLocal 是 Java 中提供的一种线程绑定机制，它为每个使用该变量的线程都提供了一个独立的变量副本，使得每个线程都可以独立地改变自己的副本而不会影响其他线程所对应的副本。
简单来说，ThreadLocal 就像是一个线程级别的“局部变量存储空间”，虽然它是全局声明的，但每个线程访问的是自己独有的值。
工作原理简述
每个线程内部持有一个 ThreadLocalMap 结构，这个 map 的 key 是 ThreadLocal 实例，value 是对应线程的变量副本。当调用 threadLocal.get() 时，实际上是去当前线程的 map 中查找以该 ThreadLocal 为 key 的值。
常见使用场景
1. 线程间数据隔离，避免参数传递
在某些业务流程中，比如从请求入口到数据库操作需要传递用户上下文（如用户 ID、权限信息），如果通过方法参数层层传递会很繁琐。ThreadLocal 可以让这些信息在整个调用链中“隐式”可用。
立即学习“Java免费学习笔记（深入）”；
创建全面的交接文档，使新AI代理能够无缝继续工作，消除歧义。解决上下文耗尽问题。 时机：(1)用户请求保存交接，(2)上下文即将满，(3)主要任务完成，(4)会话结束，(5)恢复工作时。 关键词：保存状态、创建交接、上下文已满、暂停、从...恢复、加载交接、保存进度、会话转移、交接
- 例如：Web 应用中，在过滤器（Filter）里将用户信息存入 ThreadLocal，在后续的 service 或 dao 层直接获取。
- 这样避免了把 userContext 作为参数传给每一个方法。
2. 解决线程安全问题（替代全局共享）
某些工具类不是线程安全的，比如 SimpleDateFormat。如果多个线程共用一个实例，可能引发异常或错误结果。
- 使用 ThreadLocal 为每个线程创建独立的 SimpleDateFormat 实例，既保证性能又避免同步开销。
- 示例代码：
private static final ThreadLocal<SimpleDateFormat> DATE_FORMAT =
new ThreadLocal<SimpleDateFormat>() {
@Override
protected SimpleDateFormat initialValue() {
return new SimpleDateFormat("yyyy-MM-dd");
}
};
3. 数据库连接管理（如事务控制）
在传统的 JDBC 编程中，为了实现事务的一致性，同一个事务中的所有操作必须使用同一个数据库连接。
- 可以使用 ThreadLocal 保存当前线程的 Connection 对象。
- 这样在整个事务过程中，无论调用多少层方法，都能拿到相同的连接。
- 框架如 MyBatis 的
SqlSession也利用了类似机制。
4. 日志追踪（MDC 配合使用）
虽然 MDC（Mapped Diagnostic Context）是日志框架（如 Logback）提供的功能，其底层依赖 ThreadLocal 来实现请求链路追踪。
- 可以在请求开始时设置 traceId，整个调用链的日志都会带上这个 ID。
- 便于排查问题和分析日志。
注意事项
使用 ThreadLocal 要小心内存泄漏问题。因为 key 是弱引用（WeakReference），但 value 是强引用，若 ThreadLocal 实例被回收，而线程长时间运行（如线程池中的线程），value 仍存在于 ThreadLocalMap 中，导致无法回收。
- 建议在使用完后手动调用
remove()方法清理资源。 - 尤其是在使用线程池时，务必及时清理，避免脏数据和内存泄露。
基本上就这些。ThreadLocal 不复杂但容易忽略细节，合理使用能提升代码清晰度和线程安全性。
