WebApi中NLog全局变量并发请求下串值问题求助

这个问题我之前帮不少开发者踩过坑——你误用了NLog的全局配置变量！LogManager.Configuration.Variables是全应用共享的配置对象，所有请求都会读写同一个实例，并发场景下自然会互相覆盖，导致变量值乱掉。

为什么你的代码会出问题？ #

你直接修改LogManager.Configuration.Variables["var1"]，本质是在修改整个应用的全局NLog配置。当Method1刚把var1设为5，同时Method2把它改成6时，两个请求后续的日志都会使用最新的6，完全没有请求级别的隔离性。

正确的解决方案：使用请求级别的上下文隔离 #

NLog提供了专门用于请求/线程上下文隔离的工具，最适合WebApi异步场景的是Mapped Diagnostics Logical Context (MDLC)，它基于.NET AsyncLocal特性，能在异步请求流程中稳定保持上下文隔离。

步骤1：修改NLog配置

把配置里的${var:var1}替换为MDLC的占位符：

<!-- 原配置 -->
${var:var1}
<!-- 修改后 -->
${mdlc:item=var1}

步骤2：在Api方法中设置请求上下文变量

不再修改全局配置，而是用SetScoped创建请求级别的作用域变量：

[HttpPost]
public object Method1(JObject objJobject)
{
    var log = LogManager.GetCurrentClassLogger();
    // 创建作用域，var1=5仅对当前请求有效，离开using自动清理
    using (MappedDiagnosticsLogicalContext.SetScoped("var1", "5"))
    {
        log.Info("Method1开始执行"); // 日志中var1会显示为5
        // 你的业务逻辑代码
        ...
    }
}

[HttpPost]
public object Method2(JObject objJobject)
{
    var log = LogManager.GetCurrentClassLogger();
    using (MappedDiagnosticsLogicalContext.SetScoped("var1", "6"))
    {
        log.Info("Method2开始执行"); // 日志中var1会显示为6
        // 你的业务逻辑代码
        ...
    }
}

更优雅的方式：用中间件统一处理

如果你的WebApi是.NET Core/.NET 5+，可以写一个中间件，在请求开始时自动设置var1，结束时清理，不用在每个方法里重复代码：

public class NLogRequestContextMiddleware
{
    private readonly RequestDelegate _next;

    public NLogRequestContextMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 根据请求路径或其他标识设置var1值
        var var1Value = context.Request.Path.StartsWithSegments("/api/Method1") ? "5" : "6";
        using (MappedDiagnosticsLogicalContext.SetScoped("var1", var1Value))
        {
            await _next(context);
        }
    }
}

// 在Program.cs中注册中间件（注意要放在UseRouting之后，UseEndpoints之前）
app.UseMiddleware<NLogRequestContextMiddleware>();

备选方案：Logger实例专属属性 #

如果你不想修改NLog配置，也可以给Logger实例添加专属属性，用${event-properties:item=var1}在配置中获取值：

[HttpPost]
public object Method1(JObject objJobject)
{
    var log = LogManager.GetCurrentClassLogger();
    // 创建带属性的Logger实例，仅当前方法使用
    var scopedLog = log.WithProperty("var1", "5");
    scopedLog.Info("Method1执行步骤1");
    scopedLog.Info("Method1执行步骤2");
    ...
}

这种方式适合局部场景，但需要确保所有日志调用都使用带属性的Logger实例。

关键注意事项 #

• 绝对不要在并发场景下修改NLog全局配置（LogManager.Configuration相关操作），这不是线程安全的，必然导致上下文混乱。
• MDLC是异步友好的，哪怕你的Api方法里有await异步调用，上下文也会正确传递，不会丢失。

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