ThreadLocal 为每个线程提供独立变量副本，实现数据隔离；推荐 static final 声明，用 withInitial() 或 initialValue() 设默认值；需手动 remove() 防内存泄漏，适用于单次请求上下文传递。

ThreadLocal 用来为每个线程提供独立的变量副本，实现线程间数据隔离。核心不是“共享”，而是“各用各的”——同一个 ThreadLocal 实例，在不同线程中读写的是完全不同的内存空间。

声明和初始化 ThreadLocal 变量

推荐使用 static final 修饰，避免重复创建实例；通过 initialValue() 或 withInitial() 设置默认值，确保首次 get() 时有初始值，不为空。

• 传统方式（重写 initialValue）：

private static final ThreadLocal<SimpleDateFormat> DATE_FORMAT = new ThreadLocal<>() {
    @Override
    protected SimpleDateFormat initialValue() {
        return new SimpleDateFormat("yyyy-MM-dd");
    }
};

• 简洁方式（Java 8+）：

private static final ThreadLocal<Integer> COUNTER = ThreadLocal.withInitial(() -> 0);

在业务逻辑中安全读写

调用 get() 获取当前线程专属值，set(value) 写入，remove() 主动清理（尤其在线程复用场景如线程池中必须做）。

Java Maven Secondary Analysis

分析ZIP压缩包或GitLab仓库中的Java Maven项目，确定二次开发范围、类数量、模块分布及生产相关指标。

下载

• 每次 set 前不必判空，get 会自动触发 initialValue（若已定义）
• 避免在 set 后长期不 remove：线程池中线程反复使用，残留的 ThreadLocal 值可能污染后续任务
• 典型用法示例：

int count = COUNTER.get();
COUNTER.set(count + 1);
// ... 业务处理
COUNTER.remove(); // 关键！防止内存泄漏

注意内存泄漏风险

ThreadLocal 的 key 是弱引用，但 value 是强引用。如果线程长期运行（如 Tomcat 线程池），而 ThreadLocal 实例被回收、value 却未手动 remove，就会导致 value 无法被 GC——这就是典型的内存泄漏。

立即学习“Java免费学习笔记（深入）”；

• 务必在 finally 块或 try-with-resources 中调用 remove()
• 不要依赖线程结束自动清理：线程池里的线程不会真正“结束”
• 排查技巧：Heap Dump 中搜索 java.lang.ThreadLocal$ThreadLocalMap$Entry，观察 value 是否堆积

适用场景与替代思考

适合存储**单次请求内需跨方法传递、且无需线程间共享**的数据，比如用户身份、事务上下文、日志追踪 ID。

• ✅ 推荐：Web 过滤器中存 userId，Service 层直接 get()
• ❌ 避免：代替参数传递做业务逻辑耦合；或存储大对象（如缓存 Map）
• ⚠️ 替代方案：Spring 的 RequestContextHolder（封装了 ThreadLocal）、MDC（logback 日志上下文）