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，内部维护 IR

  

  eadOnlyList
• 在 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 的契约边界；看似自由的路由，其实每一步都在和框架的约定博弈。