在 .NET 中，线程静态变量（通过
[ThreadStatic]特性或
ThreadLocal<t></t>实现）可用于在同一线程内传递上下文信息，尤其适用于无法通过方法参数直接传递的场景。它们为每个线程维护独立的数据副本，避免了多线程间的冲突，常用于日志记录、权限验证、请求跟踪等需要上下文感知的场合。
[ThreadStatic] 特性的使用方式
通过
[ThreadStatic]标记静态字段，.NET 会为每个线程创建该字段的独立实例。 适用于简单类型（如字符串、整数）或引用类型的线程局部存储 注意：不能用字段初始化语法赋初始值，否则所有线程共享该初始引用，可能引发意外共享 常见用途：保存当前请求的用户身份、事务ID、日志追踪号等
示例：
[ThreadStatic]
private static string _correlationId;
public void SetCorrelationId(string id)
{
_correlationId = id;
}
public string GetCorrelationId()
{
return _correlationId;
}
在 ASP.NET 等环境中，可在请求开始时设置该值，在整个请求处理链中读取，确保日志能关联到同一请求。
ThreadLocal 提供更安全的封装
ThreadLocal<t></t>是泛型类，比
[ThreadStatic]更灵活且易于管理。 支持构造函数传入工厂方法，自动为每个线程生成初始值 避免了
[ThreadStatic]的初始化陷阱 可显式释放资源（实现 IDisposable）
示例：
private static readonly ThreadLocal<Dictionary<string, object>> _context
= new ThreadLocal<Dictionary<string, object>>(() => new Dictionary<string, object>());
public void SetItem(string key, object value)
{
_context.Value[key] = value;
}
public object GetItem(string key)
{
_context.Value.TryGetValue(key, out var value);
return value;
}
这种方式适合构建轻量级的线程本地上下文容器。
局限性与替代方案
线程静态变量只在单一线程内有效，遇到线程切换（如 async/await）时数据会丢失。
异步方法中推荐使用AsyncLocal<t></t>，它能随任务调度自动流动
AsyncLocal<t></t>底层基于 ExecutionContext，适合现代异步编程模型 若需跨进程传递，应结合消息头、JWT 等机制序列化上下文
例如：
private static readonly AsyncLocal<string> _asyncCorrelationId = new AsyncLocal<string>();
public void Set(string id)
{
_asyncCorrelationId.Value = id;
}
这样即使在 await 后切换线程，值仍可保持。
基本上就这些。线程静态变量适合同步场景下的上下文隔离，但在异步主导的现代应用中，AsyncLocal<t></t>更可靠。选择哪种方式取决于是否涉及异步调用和执行上下文的流转需求。
