ThreadLocal通过为每个线程提供独立变量副本实现线程隔离，核心在于每个线程持有ThreadLocalMap，键为ThreadLocal实例，值为副本数据，避免并发竞争。典型应用包括：1. 用户上下文传递，如Web请求中存储用户信息；2. 数据库事务管理，绑定Connection保证事务一致性；3. 共享上下文数据如traceId减少参数传递。需注意使用后调用remove()防止内存泄漏，不适用于跨线程共享，本质是空间换时间的线程安全解决方案。
ThreadLocal 是 Java 提供的一个用于实现线程隔离的工具类，它能让每个线程都拥有自己独立的变量副本，从而避免多线程之间的数据竞争。它的核心原理和应用场景在后端开发中非常实用。
ThreadLocal 的工作原理
ThreadLocal 通过为每个线程维护一个独立的变量副本，实现数据的线程隔离。每个线程内部都有一个 ThreadLocalMap，这个 Map 的键是 ThreadLocal 实例，值是该线程对应的变量副本。
当调用 threadLocal.set(value) 时，JVM 会找到当前线程的 ThreadLocalMap，然后以当前 ThreadLocal 实例为键，存入 value。调用 threadLocal.get() 时，则从当前线程的 Map 中取出对应值。
由于每个线程操作的是自己的副本，因此不存在并发修改的问题，也不需要加锁。
立即学习“Java免费学习笔记（深入）”；
注意：ThreadLocalMap 使用弱引用作为键，防止内存泄漏，但仍需手动调用 remove() 来清理资源。典型应用场景
在 Java 后端开发中，ThreadLocal 常用于以下几种场景：
1. 用户上下文传递
在 Web 应用中，用户登录后通常需要在整个请求生命周期内访问用户信息（如 userId、token、角色等）。通过 Filter 或 Interceptor 将用户信息存入 ThreadLocal，后续业务逻辑可直接获取，无需层层传参。
- 例如：定义一个 UserContext 类，内部使用 private static ThreadLocal
holder 存储用户信息 - 请求开始时 set(user)，结束时 remove()，保证线程复用下的安全
2. 数据库事务管理
在手动管理事务时，需要保证同一个线程中多次数据库操作使用同一个 Connection。通过 ThreadLocal 绑定 Connection，可以确保事务的一致性。
- Spring 的事务管理底层就利用了 ThreadLocal 来绑定数据源连接
- 避免在多个方法间传递 Connection 对象
3. 避免频繁传参的上下文对象
某些日志追踪、链路ID（traceId）、请求参数等需要跨多个方法调用共享的数据，适合放入 ThreadLocal。
- 比如生成 traceId 放入 ThreadLocal，日志输出时自动带上，便于排查问题
- 减少方法签名中的冗余参数
使用注意事项
虽然 ThreadLocal 很方便，但使用不当容易引发问题：
- 务必在使用完后调用 remove()，尤其是在使用线程池的场景下，否则可能造成内存泄漏或脏数据
- 不要把它当成全局变量来滥用，仅用于线程内上下文传递
- 不适用于跨线程的数据共享，子线程默认无法继承父线程的 ThreadLocal 值（可通过 InheritableThreadLocal 解决）
