ThreadLocal用于线程私有数据隔离，每个线程独立读写，适合保存用户信息、事务ID等；通过set()设置、get()获取、remove()清除；可使用withInitial()设置默认值；Web应用中可用于请求级别用户上下文管理，需注意及时清理避免内存泄漏，不应用于线程间通信。
在Java中，ThreadLocal 是一种用于存储线程私有数据的机制。每个线程对该变量的读写都独立于其他线程，即使多个线程操作同一个 ThreadLocal 实例，也不会互相干扰。这非常适合在线程上下文中保存用户信息、数据库连接、事务ID等不需要共享的数据。
ThreadLocal 的基本用法
创建一个 ThreadLocal 变量非常简单，通常通过静态或实例字段声明：
private static final ThreadLocal<String> userContext = new ThreadLocal<>();
// 设置当前线程的值
userContext.set("Alice");
// 获取当前线程的值
String userName = userContext.get();
// 清除当前线程的值（推荐在线程结束前调用）
userContext.remove();
每个线程调用 set() 时，只会改变自己线程内的副本；调用 get() 时，也只会获取自己线程中的值。
初始化默认值：使用 withInitial()
如果希望 ThreadLocal 有一个初始值，可以使用 withInitial() 方法创建：
立即学习“Java免费学习笔记（深入）”；
private static final ThreadLocal<Integer> threadId =
ThreadLocal.withInitial(() -> Math.toIntExact(Thread.currentThread().getId()));
// 第一次 get() 会返回当前线程 ID，后续可 set 新值
int currentId = threadId.get();
这种方式避免了手动检查 null 并初始化的逻辑，更简洁安全。
实际应用场景示例
假设在一个Web应用中，我们想在请求处理过程中跟踪当前登录用户：
public class UserContextHolder {
private static final ThreadLocal<String> user = new ThreadLocal<>();
public static void setUser(String userName) {
user.set(userName);
}
public static String getUser() {
return user.get();
}
public static void clear() {
user.remove();
}
}
在拦截器或过滤器中设置用户：
// 模拟请求开始
UserContextHolder.setUser("Bob");
// 在同一线程的任意位置访问
String currentUser = UserContextHolder.getUser(); // 返回 "Bob"
// 请求结束时清理
UserContextHolder.clear();
由于每个请求通常由一个独立线程处理（或使用线程池但不复用期间不清除），这样能保证用户信息隔离。
注意事项与最佳实践
- 及时清理：使用完 ThreadLocal 后应调用 remove()，防止内存泄漏，尤其是在使用线程池时。
- 避免滥用：ThreadLocal 容易导致隐式依赖和调试困难，仅用于真正需要线程隔离的场景。
- 不适用于线程间通信：ThreadLocal 是为了隔离，不是为了共享。
- 注意父子线程数据传递：普通 ThreadLocal 不会自动传递到子线程，如需此功能可使用 InheritableThreadLocal。
基本上就这些。合理使用 ThreadLocal 能有效简化上下文管理，关键是记得设值后及时清理。
