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

来源：这里教程网时间：2026-02-21 17:28:06 作者：

在 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<RequestLoggingMiddleware> logger)
    {
        logger.LogInformation("请求开始: {Method} {Path}", context.Request.Method, context.Request.Path);
        await _next(context);
        logger.LogInformation("请求结束，状态码: {StatusCode}", context.Response.StatusCode);
    }
}

在 Program.cs 中注册：

app.UseMiddleware<RequestLoggingMiddleware>();

使用 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();
    });
});