是否存在Endpoint并非RouteEndpoint的场景？及Asp.net Core中二者的区别

嘿，这个问题问到点子上了！作为天天跟ASP.NET Core打交道的开发者，我来给你掰扯清楚这俩概念，还有那些非RouteEndpoint的场景～

1. 抽象层级与定位不同 #

Endpoint是所有请求处理端点的抽象基类，它定义了端点最基础的核心要素：比如处理请求的RequestDelegate、描述端点的元数据Metadata集合。简单说，它是所有“能处理请求的逻辑单元”的统称，是个大范畴。

而RouteEndpoint是Endpoint的具体子类，专门对应那些需要通过ASP.NET Core路由系统进行URL匹配后才能触发的端点。它是路由机制的产物，只针对路由相关的场景。

2. 携带的信息差异 #

RouteEndpoint比普通Endpoint多了一堆路由专属的属性：

• RoutePattern：存储端点对应的路由模板（比如/api/users/{id}）
• Order：决定路由匹配的优先级，数值越小越先匹配
• Constraints：路由约束规则（比如限制id必须是整数）
• RouteName：路由的名称（如果有设置的话）

这些属性都是为路由匹配服务的，普通Endpoint完全没有这些字段，因为它不需要参与路由匹配逻辑。

3. 适用场景的区别 #

Endpoint的适用范围更广：任何可以处理HTTP请求的逻辑，不管要不要路由，都可以封装成Endpoint。

RouteEndpoint则特指那些通过路由系统注册的端点：比如MVC的Action方法、Razor Pages页面、Web API的接口，这些都是典型的RouteEndpoint——它们依赖路由模板来匹配请求URL，然后触发对应的处理逻辑。

下面举几个实际开发中常见的例子：

1. 健康检查端点 #

ASP.NET Core自带的健康检查中间件，你可以这样注册：

app.MapHealthChecks("/health");

这个/health端点就是普通的Endpoint，而非RouteEndpoint。它不需要路由模板匹配，只是直接绑定到固定路径，没有RoutePattern、Order这些路由属性，由健康检查中间件直接处理请求。

2. WebSocket端点 #

当你用MapWebSocket注册WebSocket处理逻辑时：

app.MapWebSocket("/ws", async (context) =>
{
    var webSocket = await context.WebSockets.AcceptWebSocketAsync();
    // 处理WebSocket通信
});

这个端点也是普通的Endpoint，它不参与路由系统的匹配，只是监听特定路径的WebSocket连接请求，属于非路由端点。

3. 直接注册的自定义端点 #

用Map方法直接注册的简单端点：

app.Map("/custom", async context =>
{
    await context.Response.WriteAsync("Hello from custom endpoint!");
});

这个/custom端点没有路由模板参数，不需要路由匹配，就是一个纯粹的Endpoint，不属于RouteEndpoint。

4. SignalR Hub端点 #

当你注册SignalR Hub时：

app.MapHub<ChatHub>("/chatHub");

这个/chatHub端点同样是普通的Endpoint，它由SignalR自己的中间件处理，不依赖ASP.NET Core的路由系统进行匹配，所以也不是RouteEndpoint。

你可以在中间件里获取当前端点，通过类型判断来区分：

app.Use(async (context, next) =>
{
    var endpoint = context.GetEndpoint();
    if (endpoint != null)
    {
        if (endpoint is RouteEndpoint routeEp)
        {
            Console.WriteLine($"这是路由端点，模板：{routeEp.RoutePattern.RawText}");
        }
        else
        {
            Console.WriteLine("这是非路由端点");
        }
    }
    await next();
});

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