請(qǐng)求 →  中間件A → 中間件B → 中間件C（終端）
響應(yīng) ←  中間件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();

        // 調(diào)用 next()，請(qǐng)求繼續(xù)往下走
        await _next(context);

        // next() 返回后，響應(yīng)正在往回走
        sw.Stop();
        Console.WriteLine($"[{context.Request.Path}] 耗時(shí)：{sw.ElapsedMilliseconds}ms");
    }
}

// 在 Program.cs 中注冊(cè)
var app = builder.Build();

app.UseMiddleware<TimingMiddleware>();  // 注冊(cè)自定義中間件

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

app.Run();

app.Use(async (context, next) =>
{
    Console.WriteLine($"請(qǐng)求進(jìn)來了：{context.Request.Path}");

    await next();  // 傳遞給下一個(gè)中間件

    Console.WriteLine($"響應(yīng)回來了：{context.Response.StatusCode}");
});

app.Run(async context =>
{
    await context.Response.WriteAsync("到終點(diǎn)了，不繼續(xù)往下走");
});

請(qǐng)求進(jìn)來
  → 中間件們
    → 路由中間件（確定目標(biāo) Action）
      → 過濾器們（Action 執(zhí)行前后插手）
        → Action 執(zhí)行
      ← 過濾器們
    ← 路由中間件
  ← 中間件們
響應(yīng)返回

// 定義過濾器類，繼承 ActionFilterAttribute
public class ValidateModelAttribute : ActionFilterAttribute
{
    // 在 Action 執(zhí)行之前觸發(fā)
    public override void OnActionExecuting(ActionExecutingContext context)
    {
        if (!context.ModelState.IsValid)
        {
            // ModelState 校驗(yàn)不通過，直接短路，返回 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 = "參數(shù)校驗(yàn)失敗",
                errors
            });
        }
    }

    // 在 Action 執(zhí)行之后觸發(fā)
    public override void OnActionExecuted(ActionExecutedContext context)
    {
        // 可以在這里統(tǒng)一處理響應(yīng)，比如包一層統(tǒng)一的返回格式
    }
}

// 標(biāo)注在單個(gè) Action 上
[HttpPost]
[ValidateModel]
public IActionResult CreateUser([FromBody] CreateUserRequest request)
{
    // 走到這里說明 ModelState 已經(jīng)通過校驗(yàn)
    return Ok(new { message = "創(chuàng)建成功" });
}

// 也可以標(biāo)注在 Controller 上，對(duì)所有 Action 生效
[ApiController]
[ValidateModel]
public class UserController : ControllerBase
{
    // ...
}

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