为何ASP.NET Core中一个路由用斜杠传参，另一个用查询字符串？

配置与代码回顾 #

Program.cs 路由配置 #

app.MapControllerRoute(
    name: "index",
    pattern: "{controller=Home}/{action=Index}/{id?}"
    );
app.MapControllerRoute(
    name: "read",
    pattern: "{controller=Home}/{action=Read}/{name?}"
    );

控制器方法 #

public string Index(string id)
{
    return $"Index page {id}";
}
public string Read(string name)
{
    return $"Read page {name}";
}

实际访问结果 #

• http://localhost:5108/home/index/56 → 正常通过URL路径传递id参数
• http://localhost:5108/home/read?name=89 → name参数只能以查询字符串形式传递

核心原因：路由匹配的优先级与顺序 #

ASP.NET Core路由系统按注册顺序从上到下匹配请求，一旦某个路由模板匹配成功，就会停止后续路由的匹配逻辑。

你的第一个index路由模板{controller=Home}/{action=Index}/{id?}是一个通用程度很高的规则：

• 它支持任意控制器/动作组合（controller和action都是占位符，仅带默认值）
• 当请求home/read时，第一个路由会被优先匹配：controller解析为Home，action解析为Read，但该路由模板中没有name占位符，因此路由系统无法从URL路径中提取这个参数，只能将其转为查询字符串。

而第二个read路由根本不会被触发——因为第一个路由已经完成了匹配。

至于home/index/56的请求，第一个路由模板包含{id?}占位符，所以56能被正确识别为路径参数。

解决方法 #

方法1：调整路由注册顺序 #

将更具体的路由放在前面，让它优先匹配：

// 先注册针对性的read路由
app.MapControllerRoute(
    name: "read",
    pattern: "{controller=Home}/{action=Read}/{name?}"
    );
// 再注册通用的index路由
app.MapControllerRoute(
    name: "index",
    pattern: "{controller=Home}/{action=Index}/{id?}"
    );

调整后，请求home/read/89会优先匹配read路由，name参数就能从URL路径中提取。

方法2：使用特性路由（推荐） #

直接在控制器方法上标注路由模板，摆脱全局路由的顺序限制：

public class HomeController : Controller
{
    [Route("Home/Index/{id?}")]
    public string Index(string id)
    {
        return $"Index page {id}";
    }

    [Route("Home/Read/{name?}")]
    public string Read(string name)
    {
        return $"Read page {name}";
    }
}

这种方式每个方法的路由规则独立，逻辑更清晰，也不会出现匹配优先级问题。

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