ASP.NET Core中RequestDelegate与Middleware的区别解析

核心概念区分 #

• RequestDelegate：是.NET定义的委托类型，签名为 public delegate Task RequestDelegate(HttpContext context);，它是请求管道中「执行单元」的类型约定——任何符合该签名的方法（匿名方法、静态方法、实例方法），都能被当作RequestDelegate使用。
• Middleware（中间件）：是功能组件的抽象，指实现了HTTP请求/响应处理逻辑的代码块。RequestDelegate是中间件在请求管道中被执行时的「调用载体」，官方文档的术语混用，本质是因为内联中间件本身就是RequestDelegate实例；类形式的中间件，最终也会通过其符合RequestDelegate签名的Invoke/InvokeAsync方法，被包装成RequestDelegate加入管道。

常见疑问拆解 #

1. 匿名方法就是RequestDelegate，那Middleware在哪里？ #

当你用app.Use(async (context, next) => { ... })添加内联逻辑时，这个匿名方法本身就是内联中间件——它同时是RequestDelegate的实例。官方文档直接将这种符合RequestDelegate签名的可执行逻辑，定义为「内联中间件」。

2. 类形式的Middleware，到底是什么？ #

类形式的Middleware是封装可重用逻辑的组件载体，需满足两个核心要求：

• 构造函数接收RequestDelegate参数（用于获取管道中的下一个中间件）
• 拥有InvokeAsync(HttpContext context)方法（或Invoke，签名必须匹配RequestDelegate）

这个类是中间件的容器，其InvokeAsync方法会被ASP.NET Core框架自动包装成RequestDelegate，加入请求管道执行。

代码示例 #

1. 内联中间件（直接使用RequestDelegate） #

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// 这个匿名方法既是RequestDelegate，也是内联中间件
app.Use(async (context, next) =>
{
    // 请求处理前逻辑
    await context.Response.WriteAsync("Inline Middleware: Before Next\n");
    // 调用下一个中间件
    await next(context);
    // 请求处理后逻辑
    await context.Response.WriteAsync("Inline Middleware: After Next\n");
});

// 终端中间件（短路管道）
app.Run(async context =>
{
    await context.Response.WriteAsync("Terminal Middleware: Handle Request\n");
});

app.Run();

2. 类形式的Middleware #

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

    // 构造函数接收下一个中间件的RequestDelegate
    public CustomMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    // InvokeAsync方法符合RequestDelegate签名
    public async Task InvokeAsync(HttpContext context)
    {
        // 请求处理前逻辑
        await context.Response.WriteAsync("Custom Class Middleware: Before Next\n");
        // 调用下一个中间件
        await _next(context);
        // 请求处理后逻辑
        await context.Response.WriteAsync("Custom Class Middleware: After Next\n");
    }
}

// 扩展方法：简化中间件注册
public static class CustomMiddlewareExtensions
{
    public static IApplicationBuilder UseCustomMiddleware(this IApplicationBuilder app)
    {
        return app.UseMiddleware<CustomMiddleware>();
    }
}

// 使用类中间件
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseCustomMiddleware();

app.Run(async context =>
{
    await context.Response.WriteAsync("Terminal Middleware: Handle Request\n");
});

app.Run();

3. 管道本质：链式的RequestDelegate #

ASP.NET Core请求管道的核心是链式的RequestDelegate：

• 每添加一个中间件，都会把当前逻辑包裹在下一个RequestDelegate外层
• 执行时从第一个RequestDelegate开始，依次调用，直到终端中间件（短路管道或到达末尾）

官方文档术语混用的说明 #

官方文档中同时使用RequestDelegate和Middleware，是从两个维度描述同一逻辑：

单个请求委托可指定为内联匿名方法（称为内联中间件），或定义在可重用类中。这些可重用类和内联匿名方法就是中间件（也称为中间件组件）……

简言之：Middleware是功能层面的称呼，RequestDelegate是其在管道中执行的技术载体。示意图标注Middleware是从功能组件角度，文字描述用RequestDelegate是从管道执行单元的技术角度，二者指向同一逻辑的不同层面。

内容的提问来源于stack exchange，提问作者phougatv