ThreadLocal 提供线程局部变量，每个线程独立操作副本，适用于保存用户信息、数据库连接等场景；通过 set() 和 get() 方法存取数据，withInitial() 可设初始值避免空指针；常用于 Web 应用中传递用户上下文，需在过滤器中设置并及时调用 remove() 防止内存泄漏；使用时应避免滥用、注意线程复用问题，不用于线程间通信，必要时可选用 InheritableThreadLocal 实现父子线程间传递。
ThreadLocal 是 Java 中提供的一种线程绑定机制，用于创建线程局部变量。每个线程对 ThreadLocal 变量的读写都是独立的，互不干扰。它非常适合在多线程环境下保存线程私有的状态信息，比如用户登录信息、数据库连接、事务上下文等。
ThreadLocal 的基本用法
使用 ThreadLocal 很简单，只需要创建一个 ThreadLocal 实例，并通过 set() 和 get() 方法来存取数据：
public class ThreadLocalExample {
// 定义一个 ThreadLocal 变量
private static ThreadLocal<String> threadLocalValue = new ThreadLocal<>();
public static void main(String[] args) {
Runnable task = () -> {
// 为当前线程设置值
threadLocalValue.set(Thread.currentThread().getName() + "-data");
// 获取当前线程的值
System.out.println("当前线程: " + threadLocalValue.get());
// 模拟执行
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
// 再次查看值（仍然可以访问）
System.out.println("线程结束: " + threadLocalValue.get());
};
// 启动多个线程
new Thread(task).start();
new Thread(task).start();
new Thread(task).start();
}
}
输出结果中，每个线程都会有自己的副本，不会互相覆盖。
初始化默认值：使用 withInitial()
可以通过 ThreadLocal.withInitial() 设置初始值，避免手动判空：
立即学习“Java免费学习笔记（深入）”；
private static ThreadLocal<Integer> threadLocalCounter =
ThreadLocal.withInitial(() -> 0);
// 使用时可以直接获取，不会是 null
int count = threadLocalCounter.get(); // 默认为 0
threadLocalCounter.set(count + 1);
这种方式更安全，适合计数器、上下文对象等场景。
实际应用场景：用户上下文传递
在 Web 应用中，常使用 ThreadLocal 保存当前用户的登录信息，方便业务层调用：
public class UserContext {
private static ThreadLocal<String> userHolder = new ThreadLocal<>();
public static void setCurrentUser(String userId) {
userHolder.set(userId);
}
public static String getCurrentUser() {
return userHolder.get();
}
public static void clear() {
userHolder.remove(); // 非常重要：防止内存泄漏
}
}
// 在 Servlet 过滤器或拦截器中设置
public class AuthFilter implements Filter {
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) {
try {
String userId = extractUser((HttpServletRequest) req);
UserContext.setCurrentUser(userId);
chain.doFilter(req, res);
} finally {
UserContext.clear(); // 清理，避免线程复用导致脏数据
}
}
}
注意事项与最佳实践
- 及时清理：使用完后务必调用 remove()，特别是在线程池环境中，否则可能引发内存泄漏或数据错乱。
- 避免滥用：ThreadLocal 容易造成隐式依赖，影响代码可测试性和可维护性。
- 不适合共享数据：ThreadLocal 是为了隔离数据，不是用来在线程间通信的。
- 注意继承问题：普通 ThreadLocal 不会自动传递到子线程，如需传递，使用 InheritableThreadLocal。
