ThreadLocal 是每个线程独立副本，非线程安全共享变量；用于避免共享而非优化加锁，误用于 async/await 或漏 Dispose 会导致值残留或内存泄漏。
ThreadLocal
ThreadLocal.Value 为什么第一次读就 NullReferenceException
这不是异常，是设计行为：默认不初始化，只在首次访问 Value 时才调用工厂函数。如果工厂返回 null（比如 new ThreadLocal<stringbuilder>(() => null)</stringbuilder>），后续直接 .Append() 就崩。
- 常见错误：声明后没传工厂，或工厂逻辑里用了未初始化的静态字段
- 安全写法：始终提供非空构造，例如
new ThreadLocal<stringbuilder>(() => new StringBuilder())</stringbuilder> - 更稳妥：访问前加
if (tl.IsValueCreated) { tl.Value.Append(...) }，尤其在线程可能提前退出时 - 值类型例外：
ThreadLocal<int></int>的Value永远不会为null（默认是 0），但注意这不代表你“初始化成功了”——它只是结构体零值
线程池复用导致旧值污染新任务
.NET 线程池线程会被反复使用，而 ThreadLocal<t></t> 的值绑定到物理线程，不随任务结束自动清理。上一个后台任务留下的 DbContext 或 Regex 实例，很可能被下一个任务直接复用，引发状态混乱或连接异常。
- 典型现象：
ThreadLocal<dbcontext></dbcontext>在第二个请求中报 “The connection was not closed” 或查出上个用户的缓存数据 - 必须显式释放：在任务末尾调用
threadLocal.Dispose()，或用using包裹（仅限生命周期明确的短期任务） - 不要依赖
Value = default(T)：它只清引用，不触发IDisposable.Dispose()，资源仍驻留 - 避免在
static构造器或终结器里初始化ThreadLocal：内部依赖当前线程上下文，此时不可用
async/await 中 ThreadLocal.Value 突然变 null 或旧值
ThreadLocal<t></t> 绑定的是操作系统线程，而 await 后代码可能在另一个线程恢复执行。这意味着：同一个 async 方法里，await 前后的 Value 可能属于不同线程，甚至未初始化。
- 错误示例：
_traceId.Value = "req-123"; await Task.Delay(10); Console.WriteLine(_traceId.Value); // 输出 null - 正确替代：
AsyncLocal<t></t>，它基于ExecutionContext，能跨await流转 - 混用风险：若必须在同步代码段用
ThreadLocal，请加注释注明 “仅限同步上下文内有效” - 别指望
InheritableThreadLocal：C# 没这个类，Java 才有；.NET 里对应的是AsyncLocal<t></t>或第三方库如TransmittableThreadLocal
什么时候该用 ThreadLocal，而不是 lock 或 Interlocked
它不是同步原语，不能替代锁。适用前提是：该数据“本就不该被多个线程共用”——比如每个线程专属的缓冲区、格式化器、解析器。
- 适合场景：
ThreadLocal<regex></regex>（避免重复编译）、ThreadLocal<stringbuilder></stringbuilder>（避免频繁 new）、ThreadLocal<jsonserializeroptions></jsonserializeroptions>（避免配置争抢） - 不适合场景：计数器（用
Interlocked）、共享状态标志（用volatile或Monitor）、需跨线程通信的数据（用Channel或ConcurrentQueue） - 性能提示：
ThreadLocal<t></t>查找开销极低（本质是查当前线程对象的一个字段），比锁轻量，但比局部变量重；别为简单 int 计数器滥用它 - 内存提醒：
TrackAllValues = true会记录所有线程的值引用，调试用可以，生产禁用
最易被忽略的一点：ThreadLocal 的生命周期和线程强绑定，而线程池线程可能存活数小时。只要 ThreadLocal 实例本身还被强引用着，它持有的每个线程的值就不会被 GC —— 即使那个值是 IDisposable 对象，不 Dispose() 就等于泄漏。
