ThreadLocal用于线程私有数据隔离，每个线程独立读写，适合保存用户信息、事务ID等；通过set()设置、get()获取、remove()清除；可使用withInitial()设置默认值；Web应用中可用于请求级别用户上下文管理，需注意及时清理避免内存泄漏，不应用于线程间通信。
在Java中，ThreadLocal 是一种用于存储线程私有数据的机制。每个线程对该变量的读写都独立于其他线程，即使多个线程操作同一个 ThreadLocal 实例，也不会互相干扰。这非常适合在线程上下文中保存用户信息、数据库连接、事务ID等不需要共享的数据。
ThreadLocal 的基本用法
创建一个 ThreadLocal 变量非常简单，通常通过静态或实例字段声明：
private static final ThreadLocaluserContext = new ThreadLocal<>(); // 设置当前线程的值 userContext.set("Alice"); // 获取当前线程的值 String userName = userContext.get(); // 清除当前线程的值（推荐在线程结束前调用） userContext.remove();
每个线程调用 set() 时，只会改变自己线程内的副本；调用 get() 时，也只会获取自己线程中的值。
初始化默认值：使用 withInitial()
如果希望 ThreadLocal 有一个初始值，可以使用 withInitial() 方法创建：
立即学习“Java免费学习笔记（深入）”；
private static final ThreadLocalthreadId = ThreadLocal.withInitial(() -> Math.toIntExact(Thread.currentThread().getId())); // 第一次 get() 会返回当前线程 ID，后续可 set 新值 int currentId = threadId.get();
这种方式避免了手动检查 null 并初始化的逻辑，更简洁安全。
MyBatis3.2.3帮助文档 中文CHM版
下载
MyBatis 是支持普通 SQL 查询,存储过程和高级映射的优秀持久层框架。MyBatis 消除 了几乎所有的 JDBC 代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plan Old Java Objects,普通的 Java 对象)映射成数据库中的记录。有需要的朋友可以下载看看
实际应用场景示例
假设在一个Web应用中，我们想在请求处理过程中跟踪当前登录用户：
public class UserContextHolder {
private static final ThreadLocal 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 能有效简化上下文管理，关键是记得设值后及时清理。
