ASP.NET Core动态路由本质是运行时根据数据库或上下文实时匹配控制器/动作,需通过EndpointDataSource或前置中间件实现,而非静态MapControllerRoute;关键要遵守MVC路由契约、缓存路由数据并避免每次请求查DB。

ASP.NET Core 中动态路由的本质是 RoutePattern 的运行时构造
动态路由不是指“随时改 route table”,而是指在请求进入时,根据数据库、配置或上下文实时决定匹配哪个控制器/动作。ASP.NET Core 的 MapControllerRoute 是静态注册的,真要“动态”,得绕过常规 MVC 路由注册机制,用 IRouter 或中间件拦截后手动解析路径。
常见误区是试图在 ConfigureServices 里循环调用 MapControllerRoute——这只会注册固定几条路由,且无法响应运行时变化(比如 CMS 页面增删)。
- 真正动态的场景:多租户子域名路由(
tenant1.example.com→ 不同 Controller)、CMS 自定义路径(/about-us存在数据库中)、A/B 测试路径重写 - 关键点:路由匹配发生在
EndpointRoutingMiddleware阶段,你必须在它之前介入,或提供自定义IEndpointRouteBuilder扩展 - 性能敏感:每次请求都查 DB 做路由匹配?别这么做。缓存
ConcurrentDictionary+ 监听变更通知更实际
用自定义 IRouter 实现可更新的路由表
.NET 6+ 已不推荐直接实现 IRouter(已标记为 obsolete),但你可以用 EndpointDataSource + EndpointBuilder 构建动态端点源。核心思路是:把路由规则存在内存或 Redis,启动时加载,变更时触发 EndpointDataSource.Changed 事件通知框架刷新。
示例关键步骤:
- 定义一个
DynamicEndpointDataSource类,继承EndpointDataSource,内部维护IReadOnlyList - 在
GetEndpoints()中返回当前生效的Endpoint列表,每个Endpoint绑定到一个RequestDelegate(可转发到 MVC 或直接处理) - 用
app.UseEndpoints(endpoints => { endpoints.DataSources.Add(new DynamicEndpointDataSource()); })注册 - 路由匹配逻辑写在
RequestDelegate里:解析httpContext.Request.Path,查缓存,匹配成功则设置httpContext.Handler = controllerActionInvoker(需手动构造ActionContext)
更轻量的选择:用中间件 + UseEndpoints 前置匹配
如果只是想对特定路径前缀做动态分发(比如所有 /pages/{*slug} 走 CMS),没必要重写整个路由系统。在 UseEndpoints 前加一层中间件即可:
app.Use(async (ctx, next) =>
{
if (ctx.Request.Path.StartsWithSegments("/pages") && ctx.Request.Method == "GET")
{
var slug = ctx.Request.Path.Value.Substring("/pages".Length).Trim('/');
var page = await _pageService.GetBySlugAsync(slug); // 查 DB 或缓存
if (page != null)
{
ctx.Items["DynamicPage"] = page;
ctx.Request.Path = "/pages/render"; // 重写路径,交给 MVC 的 PagesController.Render
await next();
return;
}
}
await next();
});
注意:ctx.Request.Path 是只读的,必须用 PathString 构造新值赋给 ctx.Request.Path;ctx.Items 是传递数据的安全方式;此法不干扰原有路由表,调试也直观。
数据库驱动路由时,别忽略 RouteValueDictionary 的键名规范
动态路由最终要映射到 MVC 的 action,就得生成合法的 RouteValueDictionary(如 new RouteValueDictionary { ["controller"] = "Blog", ["action"] = "Post", ["id"] = "123" })。这里容易出错:
- 键名必须小写且严格匹配 MVC 约定:
controller、action、area,不能写成Controller或ControllerName - 值不能含 URL 编码字符(如空格、斜杠),否则
Url.Action会生成错误链接;入库前应Uri.EscapeDataString,匹配时再解码 - 若依赖区域(Area),必须确保对应
AreaAttribute已打在 Controller 上,且路由模板中包含{area:exists} - 不要在动态路由里硬编码 HTTP 方法限制——用
RequireHttpMethod("GET")扩展方法绑定到Endpoint更安全
动态性越强,越要守住 MVC 的契约边界;看似自由的路由,其实每一步都在和框架的约定博弈。











