如何在.NET 8中将日志范围共享给注入的服务

你的核心误解在于：日志范围的共享不依赖服务的Scoped生命周期，而是依托.NET的异步本地存储（AsyncLocal）实现执行上下文传递。只要在同一个BeginScope的using块内执行代码，不管服务是Scoped还是Transient，都应该能共享日志范围。你的代码逻辑本身没有问题，问题大概率出在自定义日志提供程序未正确读取当前日志范围。

验证步骤：用默认Console日志排查 #

先排除代码逻辑问题，改用.NET默认的Console日志提供程序测试：

修改Program.cs中的日志配置：

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

运行后访问/log-test，查看控制台输出。如果服务的日志消息中显示SomeScope，说明你的代码逻辑正常，问题出在自定义日志提供程序上。

修正自定义日志提供程序 #

自定义日志提供程序需要主动读取当前的日志范围链，.NET日志系统通过LoggerScope.Current静态属性暴露当前范围。以下是一个正确处理范围的自定义Logger示例：

public class CustomLogger : ILogger
{
    private readonly string _categoryName;

    public CustomLogger(string categoryName)
    {
        _categoryName = categoryName;
    }

    public IDisposable BeginScope<TState>(TState state) where TState : notnull
    {
        // 将范围推入异步本地存储
        return LoggerScope.Push(state);
    }

    public bool IsEnabled(LogLevel logLevel) => true;

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception? exception, Func<TState, Exception?, string> formatter)
    {
        // 遍历当前所有日志范围
        var scopeChain = new List<string>();
        var currentScope = LoggerScope.Current;
        while (currentScope != null)
        {
            scopeChain.Add(currentScope.State.ToString()!);
            currentScope = currentScope.Parent;
        }
        scopeChain.Reverse(); // 反转以保持范围的嵌套顺序

        var scopeText = scopeChain.Any() ? $"[{string.Join(" | ", scopeChain)}]" : "";
        // 输出包含范围的日志内容
        Console.WriteLine($"{DateTime.Now:yyyy-MM-dd HH:mm:ss} {logLevel} {scopeText} {_categoryName}: {formatter(state, exception)}");
    }
}

关键要点：

• 在BeginScope中必须调用LoggerScope.Push(state)，将范围存入异步本地存储。
• 在Log方法中遍历LoggerScope.Current获取完整的范围链，确保所有嵌套范围都被捕获。

额外排查点 #

如果默认Console日志也不显示范围，检查以下情况：

1. 是否在启动时提前实例化了SomeService（比如在Program.cs中直接调用builder.Services.BuildServiceProvider().GetRequiredService<SomeService>()），导致服务实例脱离了请求的执行上下文。
2. 是否有中间件或代码修改了执行上下文（比如错误使用ConfigureAwait(false)，但你的代码是同步执行，这种情况概率极低）。

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