ASP.NET MVC多参数路由配置异常：URL未生成预期路径格式

问题描述 #

我有一个ManageController，包含Index和Details两个Action方法，分别带有group和key参数。

期望生成的URL格式：

http://localhost:49900/Manage/1
http://localhost:49900/Manage/Details/1/sample

实际生成的URL格式：

http://localhost:49900/Manage?group=1
http://localhost:49900/Manage/Details?group=1&key=sample

现有路由配置 #

routes.MapRoute(
            name: "Manage",
            url: "{controller}/{action}/{group}",
            defaults: new { controller = "Manage", action = "Index", group = "" }
        );

routes.MapRoute(
            name: "ManageDetails",
            url: "{controller}/{action}/{group}/{key}",
            defaults: new { controller = "Manage", action = "Details", group = "", key = UrlParameter.Optional }
        );

控制器Action方法 #

public ActionResult Index(string group)
{
    return View();
}

public ActionResult Details(string group, string key)
{
    return View();
}

Action链接代码 #

<li>
    <a href="@Url.Action("Index", "Manage", new { group = "1" })">Manage</a>
</li>
<li>
    <a href="@Url.Action("Details", "Manage", new { group = "1", key = "sample" })">Manage Details</a>
</li>

解决方案 #

1. 调整路由匹配顺序 #

ASP.NET MVC路由是从上到下匹配的，更具体的路由需要放在前面。把ManageDetails路由移到Manage路由之前，确保多参数的URL优先匹配到对应的路由。

2. 优化路由模板与默认值 #

• 对于Index方法的路由，简化模板去掉URL中的action部分（因为默认就是Index），直接生成Manage/1格式。
• 移除不必要的空字符串默认值，避免路由匹配歧义。

修改后的完整路由配置：

// 优先匹配Details的多参数路由
routes.MapRoute(
    name: "ManageDetails",
    url: "{controller}/{action}/{group}/{key}",
    defaults: new { controller = "Manage", action = "Details" }
);

// 匹配Index的路由，省略action部分
routes.MapRoute(
    name: "Manage",
    url: "{controller}/{group}",
    defaults: new { controller = "Manage", action = "Index" }
);

3. 验证结果 #

保持原有的Url.Action代码不变，现在会正确生成预期URL：

• @Url.Action("Index", "Manage", new { group = "1" }) → /Manage/1
• @Url.Action("Details", "Manage", new { group = "1", key = "sample" }) → /Manage/Details/1/sample

补充说明 #

• 如果Details方法的key参数允许为空，可以保留key = UrlParameter.Optional，但要确保参数逻辑与路由匹配一致。
• 移除group的空默认值，是因为Index方法需要该参数，强制路由匹配带group的URL，避免无参数的Manage路由匹配歧义。

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