是什么

ThreadLocal 在 Java 中是一个非常有用的工具，用于在多线程环境中保持变量的局部性。简单来说，ThreadLocal 创建的变量，可以让每个使用该变量的线程都拥有该变量的独立副本，从而避免了线程之间的变量共享所带来的问题。

csharp 复制代码

public class Example1 {
    // 创建 ThreadLocal 变量
    private static ThreadLocal<Integer> threadLocalCount = ThreadLocal.withInitial(() -> 0);

    public static void main(String[] args) throws InterruptedException {
        // 线程1
        Thread thread1 = new Thread(() -> {
            for (int i = 0; i < 5; i++) {
                int count = threadLocalCount.get(); // 获取当前线程的计数
                count++;// 线程2中计数以1递增
                threadLocalCount.set(count); // 更新当前线程的计数
                System.out.println(Thread.currentThread().getName() + ": " + count);
            }
        }, "Thread 1");

        // 线程2
        Thread thread2 = new Thread(() -> {
            for (int i = 0; i < 5; i++) {
                int count = threadLocalCount.get(); // 获取当前线程的计数
                count += 10; // 线程2中计数以10递增
                threadLocalCount.set(count); // 更新当前线程的计数
                System.out.println(Thread.currentThread().getName() + ": " + count);
            }
        }, "Thread 2");

        thread1.start();
        thread2.start();

        thread1.join();
        thread2.join();
    }
}

第一个线程每次自增1，第二个线程每次自增10。

内部原理

ThreadLocal 内部通过维护一个 ThreadLocalMap，该映射表存储了线程与其局部变量之间的映射。每个线程都可以通过 ThreadLocal 存取自己的局部变量而不会影响到其他线程的局部变量。

使用场景

保持数据库连接在多线程应用程序中，每个线程可能需要执行数据库操作。如果所有线程共享一个数据库连接，那么并发访问数据库时就可能会发生冲突和不一致的情况。使用ThreadLocal可以为每个线程提供独立的数据库连接，确保操作的隔离性和一致性。

csharp 复制代码

public class DatabaseConnectionManager {
    private static ThreadLocal<Connection> connectionThreadLocal = ThreadLocal.withInitial(() -> {
        // 这里创建并返回一个数据库连接
        return createDatabaseConnection();
    });

    public static Connection getConnection() {
        return connectionThreadLocal.get();
    }

    public static void closeConnection() {
        connectionThreadLocal.get().close(); // 关闭当前线程的数据库连接
        connectionThreadLocal.remove(); // 移除 ThreadLocal 中的引用，帮助垃圾收集器回收资源
    }

    private static Connection createDatabaseConnection() {
        // 创建数据库连接的逻辑
    }
}

其他框架中使用Thread Local的例子： Spring FrameWork：Spring框架广泛使用了 ThreadLocal 来维护数据库连接，尤其是在其事务管理和数据库访问抽象层。TransactionSynchronizationManager 是一个关键的类，用于绑定资源（如数据库连接）到当前线程。Spring通过使用 ThreadLocal，让每个事务都绑定到执行事务的那个线程，从而实现了事务的一致性和隔离性。

spring-framework/spring-tx/src/main/java/org/springframework/transaction/support/TransactionSynchronizationManager.java at main · spring-projects/spring-framework

MyBatis：在 MyBatis 中，SqlSession是一个重要的接口，用于执行 SQL 命令和管理事务。MyBatis 在SessionManager类中通过使用 ThreadLocal 管理 SqlSession，保证了在同一线程中多次调用时，都是使用同一个会话，这样可以在一个数据库会话中执行多个操作，直到提交事务。

mybatis-3/src/main/java/org/apache/ibatis/session/SqlSessionManager.java at master · mybatis/mybatis-3

用户会话管理：在 Web 应用中，ThreadLocal 可以用来存储每个用户的会话信息。例如，通过在过滤器中将用户信息存储在 ThreadLocal 中，可以确保在处理用户请求的整个流程中，任何时刻都可以方便地访问到当前请求用户的信息，而不需要将用户信息通过参数传递给每个方法。
性能监控，分析性能瓶颈：使用 ThreadLocal 来存储关于线程执行开始和结束时间的信息，用于计算执行时间，从而帮助分析性能瓶颈。比如：想要监控特定部分的性能，比如数据库查询、网络调用或是复杂算法的处理时间。

优点

线程隔离的特性：非常适合于管理线程特有的状态，避免了因共享资源而导致的线程安全问题；
减少同步的需要，提高性能：无需进行额外的同步措施（加锁等）；
在某些场景下简化代码（数据库连接，会话管理）；
支持事务：通过为每个线程提供一个独立的数据库连接，ThreadLocal 确保了在同一线程中执行的所有数据库操作都在同一个事务上下文中。这有助于维护事务的一致性和隔离性。

会出现的问题

内存泄漏：最常见的问题。ThreadLocal 使用 ThreadLocalMap 来存储每个线程的局部变量，这是一个以 ThreadLocal 实例为键、线程局部变量为值的映射。如果一个 ThreadLocal 不再被使用，而线程还在运行，那么由于 ThreadLocalMap 的生命周期绑定于线程，其条目不会自动被垃圾回收。特别是在使用线程池时，线程通常会被长时间保留，这就增加了内存泄漏的风险。正确的做法是，每次使用完 ThreadLocal 存储的数据后，都应该显式调用 ThreadLocal.remove() 方法来清除数据。
内存增加：虽然 ThreadLocal 可以减少对同步的需求，但是滥用 ThreadLocal 也可能导致性能问题。每个 ThreadLocal 变量实际上是存储在每个线程的 ThreadLocalMap 中，如果大量使用 ThreadLocal 变量，特别是在创建大量线程的应用中，这可能会导致显著的内存增加。
在使用线程池的环境中，由于线程被重用，如果在任务执行完毕后没有正确清理 ThreadLocal 变量，那么这些变量的值可能会被下一个使用这个线程的任务所见。这可能会导致数据污染。
代码复杂度和可维护性：过度使用或不当使用 ThreadLocal 可能会使代码变得难以理解和维护。特别是在大型应用中，过多的 ThreadLocal 变量可能会使得跟踪线程上下文和调试变得更加困难。

ThreadLocal - 理解与使用（一）

是什么

内部原理

使用场景

优点

会出现的问题