AsyncLocal在控制器方法与作用域异常过滤器中失效问题排查

你的问题出在两个核心点上：

1. AsyncLocal的上下文传递时机错误 #

你在过滤器的构造函数中初始化AsyncLocal的值为"123"，但ASP.NET Core中Scoped过滤器的构造函数是在请求早期的执行上下文中创建的，这个上下文和后续控制器方法执行的上下文是分离的——AsyncLocal的值只会在异步调用链的上下文流转中传递，构造函数的执行上下文并没有被后续控制器方法继承，所以控制器DoWork里拿到的初始值是null。

2. 过滤器与控制器的AsyncLocal实例未共享 #

如果你的AsyncLocal是过滤器类的非静态私有字段，控制器根本无法访问到同一个实例，你在DoWork中设置的"666"其实是另一个AsyncLocal实例的值，过滤器的OnExceptionAsync自然拿不到。

步骤1：确保AsyncLocal实例全局共享 #

将AsyncLocal定义为静态字段（或封装到单例服务中），让过滤器和控制器访问同一个实例：

public class ApiExceptionFilterAttribute : ExceptionFilterAttribute
{
    // 全局共享的AsyncLocal实例
    public static AsyncLocal<string> RequestContextValue = new AsyncLocal<string>();

    public ApiExceptionFilterAttribute()
    {
        // 不要在构造函数里设置值
    }
}

步骤2：在控制器执行前的过滤器阶段设置初始值 #

放弃在构造函数中初始化，改用OnActionExecuting方法——这个方法会在控制器方法执行前的同一个执行上下文里运行，设置的AsyncLocal值会被后续控制器方法继承：

public override void OnActionExecuting(ActionExecutingContext context)
{
    RequestContextValue.Value = "123";
    base.OnActionExecuting(context);
}

步骤3：修改控制器方法验证 #

控制器DoWork中访问同一个静态AsyncLocal实例：

[ServiceFilter(typeof(ApiExceptionFilterAttribute))]
public class TestController : ControllerBase
{
    public IActionResult DoWork()
    {
        // 现在会拿到"123"
        Console.WriteLine(ApiExceptionFilterAttribute.RequestContextValue.Value);
        ApiExceptionFilterAttribute.RequestContextValue.Value = "666";
        throw new Exception();
    }
}

步骤4：在OnExceptionAsync中获取修改后的值 #

此时过滤器的OnExceptionAsync会在同一个异步上下文里执行，就能拿到修改后的"666"：

public override async Task OnExceptionAsync(ExceptionContext context)
{
    // 输出"666"
    var currentValue = RequestContextValue.Value;
    // 异常处理逻辑
    await Task.CompletedTask;
}

AsyncLocal的核心是跟随执行上下文流转，只有在同一个异步调用链的上下文中，值才会被传递。构造函数的执行时机早于请求的核心处理上下文，所以无法传递值到控制器方法。而OnActionExecuting、控制器方法、OnExceptionAsync属于同一个请求的执行上下文链，AsyncLocal的值会正确流转。

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