如何在Web API 2动作过滤器中实现非阻塞式日志记录？

嘿，我懂你的困扰——现在你的过滤器里用await Task.Delay(3000)会卡住响应，换成异步日志服务也怕重蹈覆辙对吧？别担心，这其实是因为你await了后台任务，导致整个请求流程必须等它完成才继续。下面给你几个实用的解决方案：

核心思路："火并忘记"（Fire and Forget）异步任务 #

我们的目标是让日志任务在后台悄悄跑，不影响请求响应的返回速度。关键就是不要在过滤器方法里await日志任务，而是把它丢到后台执行，同时要做好异常处理（不然出问题可能搞崩程序）。

方案1：在异步过滤器中启动后台任务 #

你可以继续用OnActionExecutedAsync，但不要await日志任务，而是用_ =来启动它，同时包裹异常处理：

public override async Task OnActionExecutedAsync(HttpActionExecutedContext actionExecutedContext, CancellationToken cancellationToken)
{
    // 先把需要的请求数据复制出来，避免后续HttpContext被回收
    var logInfo = new 
    {
        RequestPath = actionExecutedContext.Request.RequestUri.ToString(),
        ResponseStatus = actionExecutedContext.Response?.StatusCode.ToString(),
        Timestamp = DateTime.UtcNow
        // 按需添加其他日志字段
    };

    // 启动日志任务但不await，用try/catch包裹防止未处理异常
    _ = Task.Run(async () =>
    {
        try
        {
            await YourLoggingService.LogAsync(logInfo); // 替换成你的异步日志调用
        }
        catch (Exception ex)
        {
            // 这里处理日志失败的情况，比如写入本地应急日志
            // 切记：不要在这里抛出异常，否则可能导致进程终止
            Console.WriteLine($"日志记录失败: {ex.Message}");
        }
    }, cancellationToken);

    // 这里不需要await，方法会直接完成，响应正常返回
}

方案2：重写同步版过滤器方法 #

如果你觉得异步过滤器里处理后台任务有点绕，也可以重写同步的OnActionExecuted，然后在里面启动异步日志任务：

public override void OnActionExecuted(HttpActionExecutedContext actionExecutedContext)
{
    // 复制需要的日志数据
    var logData = new LogData
    {
        RequestId = actionExecutedContext.Request.Headers.Contains("Request-Id") 
            ? actionExecutedContext.Request.Headers.GetValues("Request-Id").First() 
            : Guid.NewGuid().ToString(),
        StatusCode = actionExecutedContext.Response?.StatusCode ?? HttpStatusCode.InternalServerError
    };

    // 启动异步日志任务
    _ = LogInBackgroundAsync(logData);
}

// 单独的日志处理方法，包含异常捕获
private async Task LogInBackgroundAsync(LogData logData)
{
    try
    {
        await YourLoggingService.LogAsync(logData);
    }
    catch (Exception ex)
    {
        // 异常处理逻辑
        // 比如写入本地文件或者系统日志
    }
}

关键注意事项 #

• 必须处理日志任务的异常：在.NET Framework中，未被观察到的Task异常会直接终止进程；.NET Core/.NET 5+虽然不会终止，但异常会被标记为未处理，可能导致内存泄漏或其他问题，所以一定要在后台任务里加try/catch。
• 不要直接引用HttpContext：OnActionExecuted之后，HttpContext可能会被ASP.NET回收或修改，所以一定要先把日志需要的所有数据复制到独立的对象里，再传给后台任务。
• 避免滥用"火并忘记"：这种方式只适合日志这类不影响主业务流程的场景，如果是必须执行成功的操作（比如支付回调），不能用这种方式，得用消息队列等可靠机制。

这样改造后，你的请求响应就不会被日志任务阻塞了，用户能快速拿到结果，日志在后台慢慢处理就行~

内容的提问来源于stack exchange，提问作者Zoltán Tamási