求ASP.NET Core中Log4net ThreadContext.Properties的Serilog等效实现方案

一、用Serilog实现（推荐，适配异步场景） #

Log4net的ThreadContext.Properties用于给当前线程的日志附加上下文属性，Serilog中对应的是**LogContext**——它基于AsyncLocal实现，完美适配ASP.NET Core的异步请求环境，不会出现线程切换时属性丢失的问题。

1. 启用LogContext增强

在Serilog配置中必须添加Enrich.FromLogContext()，否则LogContext的属性不会被写入日志：

var loggerConfig = new LoggerConfiguration()
    .Enrich.FromLogContext() // 关键：启用LogContext属性增强
    .WriteTo.Console(outputTemplate: "{Timestamp:HH:mm:ss} [{Level:u3}] {Message:lj} {Properties}{NewLine}")
    // 可按需添加其他输出目标（如文件、Seq等）
    .CreateLogger();

// 在ASP.NET Core中注册Serilog作为日志提供者
builder.Host.UseSerilog(loggerConfig);

2. 添加上下文属性

• 局部代码块内添加：用LogContext.PushProperty()创建作用域，离开作用域后属性自动清除

// 给这段代码的日志附加UserId属性
using (LogContext.PushProperty("UserId", "user_123"))
{
    Log.Information("用户发起登录请求");
    Log.Warning("登录尝试次数过多");
    // 以上两条日志都会携带UserId=user_123的属性
}

• 请求全局属性（如请求ID、用户身份）：通过中间件给整个请求生命周期添加属性

// 在Program.cs的中间件链中添加
app.Use(async (context, next) =>
{
    // 从HttpContext提取信息，添加到LogContext
    using (LogContext.PushProperty("RequestId", context.TraceIdentifier))
    using (LogContext.PushProperty("UserName", context.User.Identity?.Name ?? "匿名用户"))
    {
        await next();
    }
});

二、用.NET原生ILogger实现 #

如果不想引入Serilog，也可以用.NET自带的ILogger的BeginScope方法实现类似功能：

1. 配置日志提供者（以Console为例）

需要开启IncludeScopes才能显示作用域内的属性：

builder.Logging.AddConsole(options =>
{
    options.IncludeScopes = true;
});

2. 添加上下文属性

// 注入ILogger<YourService>
private readonly ILogger<YourService> _logger;

public YourService(ILogger<YourService> logger)
{
    _logger = logger;
}

public void ExecuteBusiness()
{
    // 用BeginScope包裹，添加上下文属性
    using (_logger.BeginScope(new Dictionary<string, object>
    {
        ["UserId"] = "user_123",
        ["Operation"] = "ExecuteBusiness"
    }))
    {
        _logger.LogInformation("业务操作执行完成");
    }
}

内容的提问来源于stack exchange，提问作者Vlad Popovschi