ThreadLocal的核心价值是隔离线程间状态以避免同步开销和并发风险，适用于线程私有、生命周期与线程一致的上下文数据，需配合try-finally清理、优先用withInitial()、不可跨线程传递。
ThreadLocal 的核心价值不是“简化多线程编程模型”，而是隔离线程间的状态，避免共享变量带来的同步开销和并发风险。设计得当的 ThreadLocal 能让多线程代码更清晰、更安全，但前提是理解它的适用边界和常见陷阱。
只用于真正线程私有的上下文数据
ThreadLocal 不是万能的“线程级全局变量”。它适合保存每个线程独有、生命周期与线程一致、且不需跨线程传递的数据，比如：
- 用户身份信息（如 Spring Security 的 SecurityContext）
- 事务上下文（如 Spring 的 TransactionSynchronizationManager）
- 数据库连接或 PreparedStatement 缓存（在单线程处理链中复用）
- 日志追踪 ID（如 MDC 中的 traceId）
避免用它来“替代”参数传递或共享资源管理——那会掩盖设计问题，反而增加维护成本。
配合 try-finally 或 try-with-resources 主动清理
在线程池场景下（如 Tomcat、ThreadPoolExecutor），线程会被复用，ThreadLocal 若未清理，会导致内存泄漏或脏数据残留。务必在使用后显式 remove()：
立即学习“Java免费学习笔记（深入）”；
private static final ThreadLocal<SimpleDateFormat> DATE_FORMAT = ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));
正确用法：
- 在方法入口 set()，出口 remove()（用 try-finally 保证执行）
- 若封装为工具类，提供 withContext(Runnable) 或 withContext(Supplier) 模板方法，自动完成清理
- Web 应用中，在 Filter 或 Interceptor 的 finally 块中统一清理关键 ThreadLocal
优先用 withInitial() 构造，避免 null 检查和懒初始化竞争
直接使用 ThreadLocal.withInitial() 可以延迟创建对象，且线程安全：
// 推荐：简洁、线程安全、无需判空 private static final ThreadLocal<StringBuilder> BUFFER = ThreadLocal.withInitial(StringBuilder::new); // 不推荐：手动 get()+判空+set()，易出错且可能重复初始化 private static final ThreadLocal<StringBuilder> BUFFER = new ThreadLocal<>(); // 使用时要写 if (BUFFER.get() == null) BUFFER.set(new StringBuilder()); —— 多余且不优雅
不跨线程传递，必要时用 InheritableThreadLocal 或显式拷贝
普通 ThreadLocal 的值不会被子线程继承。如果确实需要父子线程传递上下文（如异步日志 traceId），可考虑：
- InheritableThreadLocal（注意：仅对 new Thread() 有效，对线程池无效）
- 在提交任务前手动捕获并传入 Runnable/Callable
- 使用框架能力（如 CompletableFuture 的 context propagation，或 Alibaba TransmittableThreadLocal）
不要依赖默认行为做跨线程传递，否则会出现“值丢失”却难以定位的问题。
