ASP.NET Core MVC中UrlHelper.Action混合可空路由值和查询参数时解析失败问题

问题核心原因 #

这是ASP.NET Core路由系统的设计行为，并非Bug，差异来自显式传入null的路由参数的校验逻辑，以及Action参数签名对路由匹配的影响：

1. 路由参数的两种处理逻辑 #

你定义的路由模板中enterpriseId:int?是带int类型约束的可选参数，路由系统对该参数的处理会区分两种情况：

• 不传入enterpriseId这个键：路由系统判定你要省略该可选参数，直接匹配前面的{controller}/{action}段
• 显式传入enterpriseId = null：路由系统会先校验你传入的值是否符合int类型约束，null不属于有效的int类型值，会触发匹配失败校验

2. 第三行调用正常的原因 #

第三行对应的Test Action没有任何必填参数，当enterpriseId传入null触发类型校验失败后，路由系统会触发可选参数的回退逻辑：忽略该无效的可选参数值，仅用controller=Test、action=Test匹配路由模板，刚好命中规则，因此正常生成/Test/Test。

3. 第六行调用返回null的原因 #

第六行对应的TestQuery Action存在必填参数int test，路由匹配逻辑会更严格：

1. 首先校验显式传入的enterpriseId = null，不符合int类型约束，当前默认路由直接被判定为不匹配
2. 路由系统会遍历所有注册的路由模板，查找同时满足controller=Test、action=TestQuery、接收enterpriseId=null、接收test=2的路由，没有匹配项就直接返回null
3. 这里和你不传enterpriseId键的第五行调用的区别就是：第五行没有触发enterpriseId的类型校验，直接匹配成功，把test=2放到查询字符串中。

和旧版ASP.NET MVC的差异 #

旧版ASP.NET MVC的路由系统对显式传入null的可选路由参数，无论是否存在其他参数，都会直接忽略该参数，不会强制做类型约束校验，因此所有场景都能正常生成URL。

解决方案 #

方法1：过滤值为null的路由参数 #

构造RouteValueDictionary时，移除所有值为null的键，不要显式传入enterpriseId = null：

var values = new RouteValueDictionary { { "test", 2 } };
// 如果enterpriseId有有效值再添加，值为null则不添加
if (enterpriseId != null)
{
    values.Add("enterpriseId", enterpriseId);
}
urlHelper.Action("TestQuery", "Test", values);

方法2：新增无enterpriseId的兜底路由 #

在默认路由前新增一条不带enterpriseId的路由模板：

endpoints.MapControllerRoute("noEnterpriseId", "{controller=Account}/{action=Login}");
endpoints.MapControllerRoute("default", "{controller=Account}/{action=Login}/{enterpriseId:int?}");

当enterpriseId为null时会自动匹配第一条兜底路由，正常生成URL。

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