.NET中如何在函数执行期间动态更新日志记录器的作用域属性？

嗨，我正好折腾过类似的需求——在Azure Functions v4/v5里，默认的日志作用域创建后就没法修改里面的属性了，要实现动态更新RequestId、ExceptionMessage这类属性并同步到Application Insights的customDimensions，得自己搞个可变的作用域对象才行，下面给你一步步说具体怎么做：

首先，先定义一个支持动态修改属性的作用域状态类，这个类要能被日志框架识别，把里面的键值对提取出来。为了避免多线程场景下出问题，我加了锁来保护属性的读写操作：

public class MutableScopeState : IEnumerable<KeyValuePair<string, object>>
{
    private readonly Dictionary<string, object> _properties = new();
    private readonly object _lock = new();

    // 用索引器方便直接读写属性
    public object this[string key]
    {
        get
        {
            lock (_lock)
            {
                _properties.TryGetValue(key, out var value);
                return value;
            }
        }
        set
        {
            lock (_lock)
            {
                _properties[key] = value;
            }
        }
    }

    // 封装个更直观的设置属性的方法
    public void SetProperty(string key, object value)
    {
        this[key] = value;
    }

    // 让日志框架能枚举所有属性
    public IEnumerator<KeyValuePair<string, object>> GetEnumerator()
    {
        lock (_lock)
        {
            // 返回属性副本，避免枚举过程中被修改导致异常
            return new Dictionary<string, object>(_properties).GetEnumerator();
        }
    }

    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}

接下来，给ILogger写个扩展方法，方便快速创建这个可变作用域，还能顺便初始化一些初始属性：

public static class MutableLoggerScopeExtensions
{
    public static IDisposable BeginMutableScope(this ILogger logger, MutableScopeState state)
    {
        return logger.BeginScope(state);
    }

    // 重载方法：支持传入初始属性字典，同时返回可变状态对象方便后续修改
    public static IDisposable BeginMutableScope(this ILogger logger, Dictionary<string, object> initialProperties, out MutableScopeState state)
    {
        state = new MutableScopeState();
        foreach (var prop in initialProperties)
        {
            state.SetProperty(prop.Key, prop.Value);
        }
        return logger.BeginScope(state);
    }
}

现在就能在你的Azure Function里直接用了，看这个示例：

[Function("MyFunction")]
public async Task RunAsync(
    [EventHubTrigger("myhub", Connection = "EventHubConnection")] string[] events,
    ILogger log)
{
    // 初始化可变作用域，先设个默认的RequestId和空的ExceptionMessage
    var initialProps = new Dictionary<string, object>
    {
        { "RequestId", Guid.NewGuid().ToString() },
        { "ExceptionMessage", string.Empty }
    };

    // 创建作用域，拿到可变状态对象
    using var scope = log.BeginMutableScope(initialProps, out var mutableState);

    try
    {
        foreach (var message in events)
        {
            log.LogInformation("开始处理事件: {Message}", message);

            // 模拟从事件内容里提取真实的RequestId，然后动态更新作用域属性
            var realRequestId = ExtractRequestIdFromMessage(message);
            mutableState.SetProperty("RequestId", realRequestId);
            log.LogInformation("已更新RequestId为: {RequestId}", realRequestId);

            // 模拟触发异常的场景
            if (message.Contains("error"))
            {
                throw new InvalidOperationException("事件内容不符合要求");
            }
        }
    }
    catch (Exception ex)
    {
        // 发生异常时，把异常信息更新到作用域属性里
        mutableState.SetProperty("ExceptionMessage", ex.Message);
        log.LogError(ex, "处理事件时出错");
    }
}

// 模拟从消息中提取RequestId的业务逻辑
private string ExtractRequestIdFromMessage(string message)
{
    return $"REQ-{new Random().Next(1000, 9999)}";
}

最后再提几个要注意的点：

• 线程安全：我在MutableScopeState里加了lock，要是你的函数里用到了多线程操作（比如Parallel.ForEach），这个锁能保证属性修改不会出问题；如果是单线程执行，锁其实也不会有什么性能影响。
• 作用域生命周期：用using块包裹作用域，能确保函数执行完后自动释放作用域，避免内存泄漏。
• Application Insights集成：只要你的Function已经配置了App Insights的 instrumentation key 或者连接字符串，这些动态更新的属性会自动被收集到日志的customDimensions字段里，直接在App Insights里就能看到。

备注：内容来源于stack exchange，提问作者RichioRobo