.NET Web API中如何使用中间件（Middleware）

在 .NET Web API 中，中间件（Middleware）是处理 HTTP 请求和响应的核心组件。它按照配置的顺序逐个执行，可以用来实现日志记录、身份验证、异常处理、跨域（CORS）等功能。

中间件的作用与执行流程

中间件位于客户端与控制器之间，形成一个请求处理管道。每个中间件可以选择是否将请求传递给下一个组件，也可以在响应返回时进行处理。

典型的执行顺序如下：

如何注册中间件

在 Program.cs 文件中通过

app.Use...

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// 启用HTTPS重定向
app.UseHttpsRedirection();
// 启用跨域资源共享（CORS）
app.UseCors(policy => policy.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader());
// 启用身份验证（需先配置服务）
app.UseAuthentication();
app.UseAuthorization();
// 使用路由
app.UseRouting();
app.MapControllers(); // 映射控制器
app.Run();

自定义中间件的实现方式

你可以创建自己的中间件来处理特定逻辑，比如记录请求时间、检查请求头等。

有两种常见方式：基于委托和基于类。

app.Use(async (context, next) =>
{
    Console.WriteLine("请求开始：{0}", context.Request.Path);
    await next.Invoke(); // 调用下一个中间件
    Console.WriteLine("响应完成：{0}", context.Request.Path);
});

创建一个中间件类：

public class RequestLoggingMiddleware
{
    private readonly RequestDelegate _next;
    public RequestLoggingMiddleware(RequestDelegate next)
    {
        _next = next;
    }
    public async Task InvokeAsync(HttpContext context)
    {
        Console.WriteLine($"收到请求: {context.Request.Method} {context.Request.Path}");
        await _next(context);
        Console.WriteLine($"响应状态: {context.Response.StatusCode}");
    }
}

然后扩展方法便于调用：

public static class RequestLoggingExtensions
{
    public static IApplicationBuilder UseRequestLogging(this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<RequestLoggingMiddleware>();
    }
}

最后在 Program.cs 中使用：

app.UseRequestLogging();

常见中间件使用建议

UseCors()

MapControllers

UseAuthentication

UseAuthorization

UseDeveloperExceptionPage

UseExceptionHandler

UseStaticFiles()