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

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

ASP.NET Core 中动态路由的本质是 RoutePattern 的运行时构造

动态路由不是指“随时改 route table”,而是指在请求进入时,根据数据库、配置或上下文实时决定匹配哪个控制器/动作。ASP.NET Core 的 MapControllerRoute 是静态注册的,真要“动态”,得绕过常规 MVC 路由注册机制,用 IRouter 或中间件拦截后手动解析路径。

常见误区是试图在 ConfigureService

s 里循环调用 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.Pathctx.Items 是传递数据的安全方式;此法不干扰原有路由表,调试也直观。

数据库驱动路由时,别忽略 RouteValueDictionary 的键名规范

动态路由最终要映射到 MVC 的 action,就得生成合法的 RouteValueDictionary(如 new RouteValueDictionary { ["controller"] = "Blog", ["action"] = "Post", ["id"] = "123" })。这里容易出错:

  • 键名必须小写且严格匹配 MVC 约定:controlleractionarea,不能写成 ControllerControllerName
  • 值不能含 URL 编码字符(如空格、斜杠),否则 Url.Action 会生成错误链接;入库前应 Uri.EscapeDataString,匹配时再解码
  • 若依赖区域(Area),必须确保对应 AreaAttribute 已打在 Controller 上,且路由模板中包含 {area:exists}
  • 不要在动态路由里硬编码 HTTP 方法限制——用 RequireHttpMethod("GET") 扩展方法绑定到 Endpoint 更安全

动态性越强,越要守住 MVC 的契约边界;看似自由的路由,其实每一步都在和框架的约定博弈。


# redis  # cms  # 编码  # app  # ai  # 路由  # c#  # .net  # red  # gate  # mvc  # 中间件  # String  # 循环  # 继承  # 事件  # table  # 数据库  # http  # 自定义  # 重写  # 是指  # 绑定  # 路由表  # 都在  # 键名  # 可以用  # 这只  # 就得 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel Livewire是什么_使用Laravel Livewire构建动态前端界面  如何用AI帮你把自己的生活经历写成一个有趣的故事?  LinuxCD持续部署教程_自动发布与回滚机制  香港服务器建站指南:免备案优势与SEO优化技巧全解析  Laravel如何实现URL美化Slug功能_Laravel使用eloquent-sluggable生成别名【方法】  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  Internet Explorer官网直接进入 IE浏览器在线体验版网址  个人摄影网站制作流程,摄影爱好者都去什么网站?  Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能  Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言  网页制作模板网站推荐,网页设计海报之类的素材哪里好?  如何安全更换建站之星模板并保留数据?  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站?  如何在Windows环境下新建FTP站点并设置权限?  如何确认建站备案号应放置的具体位置?  Laravel如何集成微信支付SDK_Laravel使用yansongda-pay实现扫码支付【实战】  Android okhttputils现在进度显示实例代码  Windows驱动无法加载错误解决方法_驱动签名验证失败处理步骤  Laravel怎么解决跨域问题_Laravel配置CORS跨域访问  网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面?  android nfc常用标签读取总结  如何用PHP快速搭建CMS系统?  如何批量查询域名的建站时间记录?  Laravel如何保护应用免受CSRF攻击?(原理和示例)  猪八戒网站制作视频,开发一个猪八戒网站,大约需要多少?或者自己请程序员,需要什么程序员,多少程序员能完成?  Laravel如何发送系统通知?(Notification渠道示例)  香港服务器建站指南:外贸独立站搭建与跨境电商配置流程  googleplay官方入口在哪里_Google Play官方商店快速入口指南  Laravel如何配置.env文件管理环境变量_Laravel环境变量使用与安全管理  HTML5打空格有哪些误区_新手常犯的空格使用错误【技巧】  晋江文学城电脑版官网 晋江文学城网页版直接进入  html5如何实现懒加载图片_ intersectionobserver api用法【教程】  南京网站制作费用,南京远驱官方网站?  Laravel Eloquent:优雅地将关联模型字段扁平化到主模型中  东莞市网站制作公司有哪些,东莞找工作用什么网站好?  Python企业级消息系统教程_KafkaRabbitMQ高并发应用  如何续费美橙建站之星域名及服务?  Laravel Admin后台管理框架推荐_Laravel快速开发后台工具  HTML透明颜色代码怎么让图片透明_给img元素加透明色的技巧【方法】  Laravel怎么创建自己的包(Package)_Laravel扩展包开发入门到发布  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  西安专业网站制作公司有哪些,陕西省建行官方网站?  如何在阿里云虚拟机上搭建网站?步骤解析与避坑指南  如何用腾讯建站主机快速创建免费网站?  UC浏览器如何设置启动页 UC浏览器启动页设置方法  微信小程序 input输入框控件详解及实例(多种示例)  韩国网站服务器搭建指南:VPS选购、域名解析与DNS配置推荐  Windows10怎样连接蓝牙设备_Windows10蓝牙连接步骤【教程】  英语简历制作免费网站推荐,如何将简历翻译成英文?  Laravel如何构建RESTful API_Laravel标准化API接口开发指南