ThreadLocal是Java中提供线程隔离的工具类，通过为每个线程维护独立变量副本避免数据竞争。使用时需声明ThreadLocal变量，调用set()存值、get()取值、remove()清理，典型场景包括用户会话传递、数据库连接管理和线程不安全工具的封装；需注意将ThreadLocal声明为static并及时remove以防内存泄漏。
在多线程编程中，多个线程访问共享变量容易引发数据竞争问题。Java 提供了 ThreadLocal 类来解决这个问题，它可以让每个线程拥有自己独立的变量副本，从而实现线程之间的数据隔离。
ThreadLocal 是什么？
ThreadLocal 是一个线程绑定的局部变量工具类。每个线程通过 ThreadLocal 保存的值都存储在自己的 ThreadLocalMap 中，彼此互不干扰。这意味着即使多个线程操作同一个 ThreadLocal 实例，它们实际读写的是各自线程内部的副本。
如何使用 ThreadLocal
使用 ThreadLocal 很简单，通常包括定义、设置、获取和清理四个步骤：
- 声明 ThreadLocal 变量：可以是静态或实例变量，推荐声明为 static 以避免内存泄漏。
- set(T value)：将值绑定到当前线程。
- get()：获取当前线程绑定的值。
- remove()：及时清理线程本地变量，防止内存泄漏，尤其在线程池场景下非常重要。
public class UserContext {
private static final ThreadLocal userId = new ThreadLocal<>();
public static void setUserId(String id) {
userId.set(id);
}
public static String getUserId() {
return userId.get();
}
public static void clear() {
userId.remove();
}
}
// 使用示例
public class UserService {
public void process(String userId) {
UserContext.setUserId(userId);
System.out.println("Current thread: " + Thread.currentThread().getName() +
", User ID: " + UserContext.getUserId());
UserContext.clear(); // 避免资源泄露
}
}
ThreadLocal 的典型应用场景
ThreadLocal 特别适合用于传递上下文信息，而无需层层参数传递：
立即学习“Java免费学习笔记（深入）”；
- 用户会话信息：如 Web 应用中保存当前登录用户 ID。
- 数据库连接管理：在事务处理中保证同一个线程使用同一个 Connection。
- 日期格式化工具：SimpleDateFormat 不是线程安全的，可用 ThreadLocal 包装。
private static final ThreadLocaldateFormat = ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd")); public static String formatDate(Date date) { return dateFormat.get().format(date); }
注意事项与内存泄漏问题
ThreadLocal 虽然方便，但使用不当会导致内存泄漏：
- 每个 ThreadLocal 对象作为 key 存储在 Thread 的 ThreadLocalMap 中，若 ThreadLocal 没有被正确回收（比如是 static 强引用），可能导致 Entry 无法被清理。
- 建议每次使用完后调用 remove() 方法主动清除数据。
- 尽量将 ThreadLocal 声明为 private static，减少作用域，并配合注释说明其生命周期。
