ASP.NET Core 2中单个控制器如何匹配多个约定路由？

看来你在ASP.NET的路由匹配上踩了个典型的坑——约定路由的参数名绑定规则和匹配顺序问题，我来给你拆解清楚，再说说两种可行的解决方案，包括你纠结的特性路由要不要用。

一、为啥当前的约定路由不生效？ #

首先得明确：约定路由是按定义顺序从上到下匹配的，而且默认路由模板（比如{controller=Home}/{action=Index}/{id?}）里的参数占位符是id，所以当你的控制器方法参数叫searchString时，这条路由没法把URL里的值绑定到这个参数上。

你提到的第二条带searchString的路由没被用上，大概率是因为它排在了默认路由的后面——请求过来先匹配到了前面的默认路由，自然不会走到后面的路由规则。

二、两种解决思路：调整约定路由 OR 切换特性路由 #

1. 继续用约定路由：调整顺序和模板 #

如果不想改参数名，也不想换特性路由，那你需要调整全局路由的定义顺序和模板内容，把匹配searchString的路由放在默认路由前面，确保请求先匹配到它。

比如在Startup.cs里这么配置：

app.UseEndpoints(endpoints =>
{
    // 先定义专门匹配搜索的路由，放在默认路由前面
    endpoints.MapControllerRoute(
        name: "search_route",
        pattern: "{controller}/{action}/{searchString?}",
        // 可以加默认值限定只匹配你的搜索控制器/方法
        defaults: new { controller = "Product", action = "Search" }
    );

    // 再放全局默认路由
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}"
    );
});

这样当你请求/Product/Search/iphone时，就会优先匹配第一条路由，把iphone绑定到searchString参数上，而不是走到默认路由里找id参数。

2. 切换特性路由：更灵活的个性化匹配 #

如果你的搜索路由比较特殊，或者后续可能有更多个性化的路由需求，特性路由确实是更合适的选择。它可以直接在控制器方法上定义匹配规则，不用在全局路由里纠结顺序和模板，参数绑定也完全按照你指定的名称来，非常直观。

比如在你的控制器方法上加上[Route]特性：

public class ProductController : Controller
{
    // 匹配 /Product/Search/{searchString} 或者 /Product/Search（无参数）
    [Route("[controller]/[action]/{searchString?}")]
    public IActionResult Search(string searchString)
    {
        // 你的搜索逻辑
        return View();
    }
}

或者更简洁的，直接指定固定的短路由：

// 匹配 /search/{searchString} 或者 /search
[Route("search/{searchString?}")]
public IActionResult Search(string searchString)
{
    // ...
}

这样不管全局路由怎么配置，这个方法都会优先匹配你定义的特性路由，完全避开约定路由的参数名限制。

三、该怎么选？ #

• 如果只是单个方法有特殊路由需求，特性路由更轻便，不用修改全局配置，代码可读性也更高；
• 如果多个控制器/方法都有类似的参数名规则，调整约定路由可以统一管理，减少重复代码。

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