好的，我来帮你做一个 Java 中 ThreadLocal 的详解，从概念、原理、使用方法到注意事项，全面梳理。

Java ThreadLocal 详解

1️⃣ 基本概念

ThreadLocal 是 Java 提供的一种 线程本地变量，即每个线程都可以通过 ThreadLocal 拥有自己的独立变量副本，互不干扰。

特点：

• 线程隔离：每个线程操作的是自己的副本，不会被其他线程修改。
• 适合存储线程相关数据：如用户会话信息、事务上下文、数据库连接对象等。

2️⃣ 使用场景

1. 数据库连接管理：每个线程维护一个独立的 Connection。
2. 用户会话信息：Web 应用中存储当前用户信息。
3. 事务管理：每个线程单独维护事务上下文。
4. 避免参数传递：跨方法访问线程相关对象，无需显式传递参数。

3️⃣ ThreadLocal 的核心 API

4️⃣ 使用示例

4.1 基本使用

// 创建 ThreadLocal
ThreadLocal<Integer> threadLocal = new ThreadLocal<>();

// 设置值
threadLocal.set(100);

// 获取值
Integer value = threadLocal.get();
System.out.println(value); // 输出 100

// 删除值
threadLocal.remove();

4.2 使用默认值

ThreadLocal<Integer> threadLocal = new ThreadLocal<Integer>() {
    @Override
    protected Integer initialValue() {
        return 0;
    }
};

System.out.println(threadLocal.get()); // 输出 0

4.3 多线程隔离示例

ThreadLocal<String> threadLocal = new ThreadLocal<>();

Runnable task = () -> {
    threadLocal.set(Thread.currentThread().getName());
    System.out.println(Thread.currentThread().getName() + ": " + threadLocal.get());
};

Thread t1 = new Thread(task, "Thread-1");
Thread t2 = new Thread(task, "Thread-2");

t1.start();
t2.start();

输出类似：

Thread-1: Thread-1
Thread-2: Thread-2

说明每个线程有自己的独立副本。

5️⃣ ThreadLocal 的原理

1. ThreadLocalMap
   • 每个线程内部维护一个 ThreadLocalMap，存储 <ThreadLocal, value> 键值对。
   • ThreadLocal 对象作为 弱引用 存储在 Map 中，线程结束时可被 GC 回收。
2. 访问流程
   • threadLocal.set(value) → 将当前线程的 ThreadLocalMap 中对应 key 的 value 设置。
   • threadLocal.get() → 获取当前线程 ThreadLocalMap 中对应的 value。
   • 线程之间不会互相干扰。
3. 内存泄漏问题
   • 如果线程为线程池线程，ThreadLocal 对象未调用 remove()，会导致长期占用内存。
   • 解决：使用完 ThreadLocal 后必须调用 remove()。

6️⃣ 注意事项

1. 适合线程单例场景，但不适合存储大量对象。
2. 线程池环境下一定要手动 remove，避免内存泄漏。
3. 弱引用：ThreadLocal 的 key 是弱引用，value 是强引用，如果 ThreadLocal 对象被 GC 回收，value 可能无法访问，但仍占用内存。
4. 不共享数据：ThreadLocal 适合存储线程独有的数据，不适合跨线程共享。

7️⃣ 总结

• ThreadLocal 是线程局部变量，提供线程隔离存储。
• 核心用途：存储线程相关的数据，如用户信息、数据库连接、事务上下文。
• 核心方法：get()、set()、remove()、initialValue()。
• 使用时需注意 线程池环境内存泄漏问题，及时调用 remove()。

如果你需要，我可以帮你画一张 ThreadLocal 原理示意图，展示 Thread → ThreadLocalMap → <ThreadLocal, value> 的关系，这样对线程隔离和内存管理理解会更直观。

你希望我画吗？