C# 动态路由实现方法 C# ASP.NET Core如何实现Dynamic Routing

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