ASP.NET Core 中的请求委托管道如何自定义？

ASP.NET Core请求委托管道通过IApplicationBuilder配置，使用Use、Run、Map方法构建中间件流程。自定义中间件推荐强类型类，支持依赖注入，如日志中间件记录请求全过程。Use添加可继续管道的中间件，Run终止管道，Map按路径分支。可通过MapWhen条件分支，中间件顺序决定执行逻辑，常见顺序为异常处理→静态文件→认证→授权→路由→终结点。日志等跨切面中间件应前置以覆盖完整生命周期。

在 ASP.NET Core 中，请求委托管道（也称为中间件管道）决定了每个 HTTP 请求的处理流程。你可以通过自定义中间件来扩展或修改这个管道，实现如日志记录、身份验证、异常处理等跨切面功能。

理解请求委托管道

ASP.NET Core 使用 IApplicationBuilder 来配置中间件管道。每个中间件组件是一个委托，负责处理 HttpContext 并决定是否将请求传递给下一个中间件。

核心方法是 Use、Run 和 Map：

• Use：添加中间件并显式调用 next() 继续管道
• Run：终止管道，不调用下一个中间件
• Map：基于路径分支管道

自定义中间件的实现方式

推荐使用强类型的中间件类，结构清晰且支持依赖注入。

定义中间件类：

public class RequestLoggingMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task InvokeAsync(HttpContext context, ILogger logger)
    {
        logger.LogInformation("请求开始: {Method} {Path}", context.Request.Method, context.Request.Path);
        await _next(context);
        logger.LogInformation("请求结束，状态码: {StatusCode}", context.Response.StatusCode);
    }
}

在 Program.cs 中注册：

Elser AI Comics

一个免费且强大的AI漫画生成工具，助力你三步创作自己的一出好戏

下载

app.UseMiddleware();

使用 Use 方法直接添加委托

适合轻量逻辑，例如添加响应头：

app.Use(async (context, next) =>
{
    context.Response.Headers["X-Custom-Header"] = "MyApp";
    await next();
});

条件性执行与分支管道

根据路径或条件隔离中间件执行：

app.Map("/admin", adminApp =>
{
    adminApp.UseAuthentication();
    adminApp.UseAuthorization();
    adminApp.UseRouting();
    adminApp.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
});

也可以使用 MapWhen 基于任意条件分支：

app.MapWhen(context => context.Request.Query.ContainsKey("debug"), appBuilder =>
{
    appBuilder.Use(async (ctx, next) =>
    {
        ctx.Response.Headers["X-Debug-Mode"] = "true";
        await next();
    });
});

控制中间件顺序

顺序至关重要。常见顺序如下：

• 异常处理（开发/生产环境）
• 静态文件服务
• 认证与授权
• 路由
• 终结点（控制器、Razor 页面等）

自定义中间件应根据其职责插入合适位置。比如日志中间件通常放在靠前位置，以捕获完整生命周期。