ASP.NET Core 6 MVC指定命名路由传参失效问题咨询

我开发的ASP.NET Core 6 MVC应用包含首页和支出页面，首页通过链接向支出页面的Index动作方法传递整数类型的systemId参数，该方法会在视图中显示传入的systemId值。

我在代码中定义了名为systemid的命名路由，并且在首页的链接中使用asp-route="systemid"指定该路由，同时通过asp-all-route-data传递路由数据。但点击链接后，ExpenditureController的Index方法中systemId参数始终为0。若将systemid路由的注册顺序放在默认路由之前，参数就能正常传递。

我疑惑的是，明明已经通过asp-route显式指定了命名路由，为何仍会匹配先注册的默认路由？

问题原因 #

这本质是ASP.NET Core路由系统在生成URL阶段的匹配逻辑导致的：

1. 路由生成的优先级规则：即使你通过asp-route指定了命名路由，框架仍会先验证该路由是否能完全匹配你提供的路由数据。如果先注册的默认路由也能生成一个符合基本要求的URL（比如匹配controller和action），框架可能会优先选择先注册的路由，而非严格遵循命名路由的指定。
2. 参数绑定的差异：你的默认路由模板（通常是{controller=Home}/{action=Index}/{id?}）里没有systemId参数，所以生成URL时会把systemId作为查询字符串附加到末尾。但你的Index方法的systemId参数是绑定到路由模板的，无法读取查询字符串的值，因此只能取默认值0。
3. 命名路由的位置影响：当把systemid路由放在默认路由之前时，框架在生成URL时会优先检查这个特定路由，它的模板包含systemId参数，会直接把参数嵌入到URL路径中，控制器方法就能正确从路由模板绑定到参数值。

解决方案 #

1. 明确命名路由的唯一性：给命名路由添加更具体的模板或约束，避免与默认路由的模板重叠。例如：

   app.MapControllerRoute(
       name: "systemid",
       pattern: "Expenditure/Index/{systemId:int}",
       defaults: new { controller = "Expenditure", action = "Index" });
   

2. 确保路由数据与参数名称完全匹配：asp-all-route-data中的键名要和路由参数名一致（注意大小写，路由参数名称区分大小写），比如用"systemId"而非"systemid"。
3. 固定路由注册顺序：将特定业务的命名路由放在默认路由之前注册，确保框架优先使用这些路由生成URL。

内容的提问来源于stack exchange，提问作者endurium