beginscope 是为日志注入结构化、可嵌套键值对元数据的上下文机制，基于 asynclocal 实现作用域隔离，需配合 using 使用才能生效。
BeginScope 是什么，为什么需要它
在 C# 的 Microsoft.Extensions.Logging 中，BeginScope 不是给日志加“前缀”或“标签”的装饰器，而是为当前执行上下文注入结构化、可嵌套的键值对元数据。它解决的核心问题是：当多个请求/任务并行处理时，如何让每条日志自动带上当前请求 ID、用户 ID、操作名等上下文信息，而不用在每个 logger.LogInformation 调用里手动拼接。
它的本质是利用 AsyncLocal<idisposable></idisposable>（.NET Core 2.1+）实现作用域隔离，确保子线程/异步延续也能继承父作用域——但前提是日志提供程序支持（如 ConsoleLogger、ApplicationInsightsLoggerProvider 默认支持；自定义 provider 需显式读取 State）。
BeginScope 的三种常用传参方式及适用场景
BeginScope 接收 object 类型参数，实际行为取决于传入内容的类型：
- 传入
string：仅作为作用域名称显示（无结构化能力），例如logger.BeginScope("OrderProcessing")→ 日志中可能显示为[OrderProcessing]，但无法提取字段 - 传入匿名对象（推荐）：生成结构化 scope，字段可被序列化和查询，例如
logger.BeginScope(new { OrderId = orderId, UserId = userId })→ 输出 JSON-like 字段，Log Analytics 或 Seq 可直接过滤OrderId == "123" - 传入
IDictionary<string object></string>：适合动态构建上下文（如从 HTTP header 解析），但需注意 key 名不能含空格或特殊字符，否则部分 provider 会静默丢弃
BeginScope 必须配合 using 才能生效
很多人写完 BeginScope 就以为上下文已激活，结果日志没带任何 scope 字段——根本原因是没正确释放作用域。作用域生命周期由 IDisposable 控制，必须用 using 块包裹，否则 scope 在方法退出后不会自动结束，甚至污染后续日志：
// ✅ 正确：using 确保 scope 在块结束时 Dispose
using (logger.BeginScope(new { Controller = "Orders", Action = "Create" }))
{
logger.LogInformation("Order created successfully");
// 这条日志会包含 Controller 和 Action 字段
}
<p>// ❌ 错误：scope 没有释放，可能持续到整个请求结束
var scope = logger.BeginScope(new { Controller = "Orders" });
logger.LogInformation("This log may or may not include scope");
// scope.Dispose() 被遗忘 → 后续日志可能意外携带该 scope
</p>
ASP.NET Core 中，MVC / Minimal API 已自动为每个请求创建顶层 scope（含 RequestId, RequestPath），你只需在业务逻辑内嵌套自己的 using 即可叠加。
常见陷阱：Scope 字段不出现、重复嵌套、性能开销
以下问题最常被忽略：
-
ConsoleLogger默认只在Debug或Trace级别输出 scope 字段，Information级别默认不显示 —— 不是没生效，是控制台没打印。改用JsonConsoleFormatter或切换到ApplicationInsights即可见完整结构 - 过度嵌套 scope（比如循环内反复
BeginScope）会导致 scope 链过长，某些 provider（如早期 Serilog.Sinks.Console）会截断或抛StackOverflowException - 每次
BeginScope都会分配新对象并触发AsyncLocal更新，高频短生命周期操作（如每毫秒调用一次）应避免在 hot path 使用；可考虑复用IDictionary实例或改用LogValues手动注入
Scope 的真正价值不在“看起来更整齐”，而在于日志聚合系统能按字段精确下钻——如果用不到结构化查询，硬加 scope 反而增加序列化负担。
