.NET 中的日志记录范围如何关联操作？

来源：这里教程网时间：2026-02-21 17:28:25 作者：

在 .NET 中，日志记录范围（Logging Scope）通过 ILogger.BeginScope 方法来创建，能够将一组日志条目关联到同一个上下文或操作中。这种机制有助于在复杂调用链中追踪特定操作的执行流程，尤其是在处理请求、事务或后台任务时非常有用。

日志范围的基本作用

日志范围允许你为一批日志添加共享的上下文信息。例如，在一个 Web 请求中，你可以创建一个包含请求 ID 或用户信息的范围，这样该请求期间的所有日志都会自动携带这些数据。

范围通常以键值对的形式存储，支持结构化日志输出（如使用 Serilog 或 Application Insights 时），便于后续查询和分析。

如何将范围与操作关联

要将日志范围与某个操作关联，可以在方法开始时调用 BeginScope，并在 using 块内执行相关逻辑。超出作用域后，范围会自动结束。

示例代码：

using (logger.BeginScope(new { RequestId = "req-123", UserId = "user-456" }))
{
    logger.LogInformation("开始处理用户请求");
    // 执行具体业务逻辑
    ProcessOrder();
    logger.LogInformation("请求处理完成");
}

在这个例子中，两条日志都会附带 RequestId 和 UserId，从而明确属于同一次操作。

与依赖注入和中间件的集成

在 ASP.NET Core 应用中，可以利用中间件自动为每个请求创建日志范围。例如，内置的 RequestLoggingMiddleware 可以记录整个请求的上下文，包括路径、状态码等。

你也可以自定义中间件，在请求开始时建立包含跟踪 ID 的范围：

app.Use(async (context, next) =>
{
    var requestId = context.TraceIdentifier;
    using (loggerFactory.CreateLogger("Request").BeginScope(new { RequestId = requestId }))
    {
        await next();
    }
});

这样，整个请求生命周期中的日志都能关联到同一个 requestId。