AsyncLocal 是异步上下文（ExecutionContext）中的快照式数据副本，用于在 async/await 链中自动传递独立的逻辑上下文数据（如跟踪 ID），其值随 ExecutionContext 捕获与还原而“延续”，每个异步分支持有独立副本，不共享状态，也不适用于跨线程或 Task.Run 场景。
AsyncLocal 不是线程本地存储，也不是“跨线程共享变量”，它本质是异步上下文（ExecutionContext）中的一份快照式数据副本。它的行为取决于 ExecutionContext 的捕获与还原机制，而非线程 ID 或堆内存地址。
AsyncLocal 的值为什么在 await 后“看起来”延续了？
关键点在于：
-
await默认会捕获当前的ExecutionContext（含AsyncLocal值），并在 await 完成后尝试还原它； - 这个“还原”不是赋值操作，而是对当前异步执行路径所绑定的
AsyncLocal实例做一次 逻辑上的继承拷贝 —— 每个异步分支都拥有自己独立的Value引用（哪怕指向同一对象）； - 所以你在
Task.Run里修改context.Value.Name，主流程最后看到的是最后一次写入的值，是因为两个Task.Run是串行 await 的，第二个覆盖了第一个的变更。
常见误判现象：
- 认为
AsyncLocal<T>能安全用于并发写入场景（❌ 实际上多个并行任务会各自持有副本，互不干扰）； - 在
Task.Run(() => { context.Value = ... })中赋值后，期望主线程立刻看到变化（✅ 仅当该 Task 是 await 的、且未被ConfigureAwait(false)截断上下文时才成立）； - 把
AsyncLocal当作全局状态容器（⚠️ 它只对当前异步调用链有效，一旦脱离 ExecutionContext 流，比如进入新线程池线程且未显式传递，就丢失）。
AsyncLocal 的构造函数参数 onValueChanged 有什么实际用途？
这个回调会在每次 Value 被设为新引用（不是对象内部字段修改）时触发，且传入旧值和新值。但它有严格限制：
- 回调本身运行在
ExecutionContext还原后的上下文中（即和赋值处一致的异步流）； - 不可用于同步阻塞操作（如
Thread.Sleep、锁、文件 I/O），否则可能拖慢整个异步链； - 最典型用法是做「上下文生命周期跟踪」，例如记录请求 ID 的创建/销毁：
var traceId = new AsyncLocal<string>(args =>
{
if (args.PreviousValue != null && args.CurrentValue == null)
Log($"Trace {args.PreviousValue} ended");
else if (args.PreviousValue == null && args.CurrentValue != null)
Log($"Trace {args.CurrentValue} started");
});注意：args.CurrentValue == null 并不表示“值被清空”，而是当前异步分支退出时自动重置为默认值（default(T)），这是 ExecutionContext 还原机制的一部分。
AsyncLocal 和 CallContext.LogicalSetData / HttpContext.Items 的区别在哪？
-
CallContext.LogicalSetData（.NET Framework 旧 API）：已废弃，不支持 async/await，会在await后丢失； -
HttpContext.Items（ASP.NET Core）：仅限 HTTP 请求生命周期内有效，底层其实也依赖AsyncLocal实现（HttpContext对象本身由AsyncLocal<HttpContext>管理）； -
AsyncLocal：无框架依赖，纯 .NET 运行时能力（.NET 4.6+ / .NET Core 1.0+），适用于任意异步链，包括控制台、后台服务、gRPC 方法等。
性能影响方面：
- 每个
AsyncLocal实例都会增加ExecutionContext的拷贝开销； - 高频创建/销毁异步方法（如每毫秒上千次
Task.Run）时，大量AsyncLocal可能成为 GC 压力源； - 若只是临时透传一个 ID，用
async Task<T> MethodAsync(CancellationToken ct, string traceId)显式传参，往往比依赖AsyncLocal更轻量、更可控。
AsyncLocal 最容易被忽略的点是：它不阻止你把可变对象塞进去，但也不会帮你深拷贝。如果你往 AsyncLocal<Person> 里塞同一个 Person 实例，然后在不同分支里改 .Name，表面上看是“共享”，其实是引用共享——这和 AsyncLocal 无关，纯粹是对象引用语义导致的。真要隔离，得确保每次赋值都是新实例。
