聊聊 ASP.NET Core 中间件和过滤器的区别解析

请求 →  中间件A → 中间件B → 中间件C（终端）
响应 ←  中间件A ← 中间件B ←

// 定义中间件类
public class TimingMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task InvokeAsync(HttpContext context)
    {
        var sw = Stopwatch.StartNew();

        // 调用 next()，请求继续往下走
        await _next(context);

        // next() 返回后，响应正在往回走
        sw.Stop();
        Console.WriteLine($"[{context.Request.Path}] 耗时：{sw.ElapsedMilliseconds}ms");
    }
}

// 在 Program.cs 中注册
var app = builder.Build();

app.UseMiddleware<TimingMiddleware>();  // 注册自定义中间件

app.UseRouting();
app.UseAuthorization();
app.MapControllers();

app.Run();

app.Use(async (context, next) =>
{
    Console.WriteLine($"请求进来了：{context.Request.Path}");

    await next();  // 传递给下一个中间件

    Console.WriteLine($"响应回来了：{context.Response.StatusCode}");
});

app.Run(async context =>
{
    await context.Response.WriteAsync("到终点了，不继续往下走");
});

请求进来
  → 中间件们
    → 路由中间件（确定目标 Action）
      → 过滤器们（Action 执行前后插手）
        → Action 执行
      ← 过滤器们
    ← 路由中间件
  ← 中间件们
响应返回

// 定义过滤器类，继承 ActionFilterAttribute
public class ValidateModelAttribute : ActionFilterAttribute
{
    // 在 Action 执行之前触发
    public override void OnActionExecuting(ActionExecutingContext context)
    {
        if (!context.ModelState.IsValid)
        {
            // ModelState 校验不通过，直接短路，返回 400
            var errors = context.ModelState
                .Where(e => e.Value?.Errors.Count > 0)
                .ToDictionary(
                    e => e.Key,
                    e => e.Value!.Errors.Select(x => x.ErrorMessage).ToArray()
                );

            context.Result = new BadRequestObjectResult(new
            {
                code = 400,
                message = "参数校验失败",
                errors
            });
        }
    }

    // 在 Action 执行之后触发
    public override void OnActionExecuted(ActionExecutedContext context)
    {
        // 可以在这里统一处理响应，比如包一层统一的返回格式
    }
}

// 标注在单个 Action 上
[HttpPost]
[ValidateModel]
public IActionResult CreateUser([FromBody] CreateUserRequest request)
{
    // 走到这里说明 ModelState 已经通过校验
    return Ok(new { message = "创建成功" });
}

// 也可以标注在 Controller 上，对所有 Action 生效
[ApiController]
[ValidateModel]
public class UserController : ControllerBase
{
    // ...
}

builder.Services.AddControllers(options =>
{
    options.Filters.Add<ValidateModelAttribute>();  // 全局注册
});