无法配置内置日志提供程序时，ASP.NET Core 5如何添加日志额外信息

方法一：利用日志范围（Logger Scope） #

这种方式无需修改原有日志调用代码，也不用改动内置日志提供器的配置，通过上下文范围自动注入信息：

1. 添加日志范围中间件
   在Startup.cs的Configure方法中（或单独编写一个中间件类），从请求上下文获取UserId并创建日志范围：

app.Use(async (context, next) =>
{
    // 示例：从用户Claims中获取UserId，无值时用默认123
    var userId = context.User.FindFirstValue(ClaimTypes.NameIdentifier) ?? "123";
    
    // 创建包含UserId的日志范围，后续所有日志都会自动带上该信息
    using (logger.BeginScope("UserId: {UserId}", userId))
    {
        await next();
    }
});

注意要将ILogger注入到中间件中。

ASP.NET Core内置的Console、Debug等日志提供器，默认会输出范围中的内容，最终日志会自动呈现类似UserId: 123; Hello World的格式。

方法二：自定义Logger包装器 #

通过包装原生ILogger接口，手动拼接额外信息，对所有日志调用生效：

1. 编写包装类

public class UserIdLogger<T> : ILogger<T>
{
    private readonly ILogger<T> _innerLogger;
    private readonly IHttpContextAccessor _httpContextAccessor;

    public UserIdLogger(ILogger<T> innerLogger, IHttpContextAccessor httpContextAccessor)
    {
        _innerLogger = innerLogger;
        _httpContextAccessor = httpContextAccessor;
    }

    public IDisposable BeginScope<TState>(TState state) => _innerLogger.BeginScope(state);

    public bool IsEnabled(LogLevel logLevel) => _innerLogger.IsEnabled(logLevel);

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
    {
        // 获取UserId，根据实际场景调整来源
        var userId = _httpContextAccessor.HttpContext?.User.FindFirstValue(ClaimTypes.NameIdentifier) ?? "123";
        // 拼接原日志消息与UserId
        var customFormatter = (TState s, Exception e) => $"UserId: {userId}; {formatter(s, e)}";
        // 调用原生日志方法输出拼接后的内容
        _innerLogger.Log(logLevel, eventId, state, exception, customFormatter);
    }
}

2. 替换日志服务实现
   在Startup.cs的ConfigureServices中注册自定义包装器，并添加HttpContext访问器：

services.AddHttpContextAccessor();
services.AddScoped(typeof(ILogger<>), typeof(UserIdLogger<>));

之后业务代码中调用logger.LogInfo("Hello World")时，内置日志提供器会自动拿到拼接后的完整消息。

注意事项 #

• 如果UserId不是来自HttpContext（比如后台任务），需要调整获取逻辑，比如从线程上下文或其他存储中读取。
• 方法一的日志范围更轻量，适合请求上下文场景；方法二的包装器灵活性更高，可自定义任意拼接逻辑。

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