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<string routevaluedictionary></string>+ 监听变更通知更实际
用自定义 IRouter
实现可更新的路由表
.NET 6+ 已不推荐直接实现
IRouter（已标记为 obsolete），但你可以用
EndpointDataSource+
EndpointBuilder构建动态端点源。核心思路是：把路由规则存在内存或 Redis，启动时加载，变更时触发
EndpointDataSource.Changed事件通知框架刷新。
示例关键步骤：
定义一个DynamicEndpointDataSource类，继承
EndpointDataSource，内部维护
IReadOnlyList<endpoint></endpoint>在
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 的契约边界；看似自由的路由，其实每一步都在和框架的约定博弈。
