java怎么使用ThreadLocal 使用ThreadLocal保存线程独立变量_技术教程

ThreadLocal 提供线程局部变量，每个线程独立操作副本，适用于保存用户信息、数据库连接等场景；通过 set() 和 get() 方法存取数据，withInitial() 可设初始值避免空指针；常用于 Web 应用中传递用户上下文，需在过滤器中设置并及时调用 remove() 防止内存泄漏；使用时应避免滥用、注意线程复用问题，不用于线程间通信，必要时可选用 InheritableTh
readLocal 实现父子线程间传递。

ThreadLocal 是 Java 中提供的一种线程绑定机制，用于创建线程局部变量。每个线程对 ThreadLocal 变量的读写都是独立的，互不干扰。它非常适合在多线程环境下保存线程私有的状态信息，比如用户登录信息、数据库连接、事务上下文等。

ThreadLocal 的基本用法

使用 ThreadLocal 很简单，只需要创建一个 ThreadLocal 实例，并通过 set() 和 get() 方法来存取数据：

public class ThreadLocalExample {
    // 定义一个 ThreadLocal 变量
    private static ThreadLocal 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() 设置初始值，避免手动判空：

private static ThreadLocal threadLocalCounter = 
    ThreadLocal.withInitial(() -> 0);

// 使用时可以直接获取，不会是 null
int count = threadLocalCounter.get(); // 默认为 0
threadLocalCounter.set(count + 1);

这种方式更安全，适合计数器、上下文对象等场景。

实际应用场景：用户上下文传递

在 Web 应用中，常使用 ThreadLocal 保存当前用户的登录信息，方便业务层调用：

public class UserContext {
    private static ThreadLocal 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(); // 清理，避免线程复用导致脏数据
        }
    }
}