ASP.NET Core如何识别.NET WebAPI请求对应的目标端点？

问题场景 #

我有一个.NET WebAPI项目，定义了以下端点：

• GET /api/controller1/{id}
• GET /api/controller1/{id}/summary
• GET /api/controller1/{name}/{surname}

当发送请求 http://localhost:5001/api/controller1/5/summary 时，ASP.NET Core会匹配到第二个端点。想了解它的匹配逻辑，查看源码但未找到相关部分。

核心匹配规则 #

ASP.NET Core路由系统通过路由模板的特异性优先级来确定匹配的端点，核心逻辑如下：

1. 分段数量优先 #

路由模板按/拆分为多个分段，分段数量越多的模板，匹配优先级越高。你的请求URL包含4个分段：api、controller1、5、summary，第二个端点的模板正好对应4个分段，而第一个端点只有3个分段，因此第二个端点会被优先纳入匹配范围。

2. 字面量分段优于参数分段 #

对于分段数相同的模板，固定字符串（字面量）分段的优先级高于参数化分段（如{id}）。第二个端点的最后一个分段是字面量summary，而第三个端点的最后两个分段都是参数，因此第二个模板的特异性更高，会被优先匹配。

3. 参数类型的辅助筛选 #

如果存在分段数和字面量占比都相同的模板，参数的类型约束（如int、string）会进一步筛选匹配项，但你的场景中不存在这种情况。

源码中的关键实现 #

如果你想在ASP.NET Core源码中定位逻辑，可以重点关注以下核心组件：

• RouteMatcher类：负责统筹所有端点的匹配过程，其MatchAsync方法是匹配流程的入口。
• TemplateMatcher类：用于计算单个路由模板的匹配权重和匹配结果，构造函数中会根据分段类型（字面量/参数）计算模板的总权重——权重越高，优先级越高。
• 权重计算逻辑：字面量分段的权重高于参数分段，分段数量越多总权重越高，系统会选择权重最高且完全匹配的端点。

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