线程安全的ThreadLocal用途：每个线程自己的小抽屉

在多ref="/tag/413/" style="color:#EB6E00;font-weight:bold;">线程编程中，数据共享常常带来麻烦。比如多个线程同时操作同一个变量，结果可能乱成一锅粥。为了解决这个问题，除了加锁，Java 还提供了一个更巧妙的工具——ThreadLocal。

ThreadLocal 是什么？

你可以把 ThreadLocal 想象成每个线程专属的“小抽屉”。每个线程往自己的抽屉里放东西，互不干扰。即使多个线程使用同一个 ThreadLocal 变量，它们实际操作的是各自线程内部的副本。

这就天然避免了线程安全问题，因为根本没有共享，自然不需要争抢和加锁。

一个简单的例子

比如我们想在每个请求处理过程中记录用户信息，但又不想通过参数层层传递。这时候 ThreadLocal 就派上用场了：

public class UserContext {
    private static final ThreadLocal<String> userId = new ThreadLocal<>();

    public static void set(String id) {
        userId.set(id);
    }

    public static String get() {
        return userId.get();
    }

    public static void clear() {
        userId.remove();
    }
}

在 Web 应用中，可以在用户登录后调用 UserContext.set(userId)，之后在整个请求链路中任何地方都能通过 UserContext.get() 获取当前用户，就像随身带着一张便签纸。

常见的使用场景

数据库连接管理是个典型例子。很多框架在事务处理时，会把 Connection 存入 ThreadLocal，确保同一个线程在整个事务中使用的是同一个连接，既高效又安全。

还有像日期格式化工具 SimpleDateFormat，它本身不是线程安全的。如果多个线程共用一个实例，解析出来的日期可能错乱。用 ThreadLocal 包装一下，每个线程都有自己的格式化实例，问题就解决了。

public class DateUtils {
    private static final ThreadLocal<SimpleDateFormat> formatter =
        ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));

    public static String format(Date date) {
        return formatter.get().format(date);
    }
}

需要注意的地方

ThreadLocal 虽好，但别忘了清理。特别是在使用线程池的场景下，线程会被复用，如果不手动调用 remove()，上次的数据可能残留在 ThreadLocal 中，造成内存泄漏或数据错乱。

就像借用图书馆的储物柜，用完不清理，下一个人打开可能看到你的私人物品，挺尴尬的。

所以，建议在 finally 块中或者拦截器末尾及时清除：

try {
    UserContext.set("user123");
    // 处理业务
} finally {
    UserContext.clear(); // 主动清理
}

ThreadLocal 不是万能药，但它在特定场景下确实优雅地解决了线程隔离的问题。用对了，代码简洁又安全；用错了，可能埋下隐患。关键还是理解它的本质：给每个线程配一个独立的空间，各过各的，互不打扰。