Web API 2多路由配置问题：按名称/ID路由互斥如何解决？

这个问题我之前也碰到过！核心原因是你这两个路由的模板结构完全一样——都是api/{controller}/{action}/{参数}，Web API的路由系统是按顺序匹配的，它不管参数名是id还是name，只要结构对上就会用第一个匹配的路由，所以才会出现谁在前谁生效的情况。给你几个靠谱的解决办法：

方法一：给路由模板添加明确的参数前缀 #

直接修改路由模板，给不同参数类型加上专属前缀，让路由系统能直接区分。比如：

config.Routes.MapHttpRoute(
    name: "IDApi",
    routeTemplate: "api/{controller}/{action}/id/{id}",
    defaults: new { id = RouteParameter.Optional }
);
config.Routes.MapHttpRoute(
    name: "NameApi",
    routeTemplate: "api/{controller}/{action}/name/{name}",
    defaults: new { name = RouteParameter.Optional }
);

之后调用的时候就用：

• api/customer/getByID/id/5（匹配ID路由）
• api/customer/searchByName/name/fawzy（匹配Name路由）
  这种方式最直观，完全不会有冲突。

方法二：给路由添加参数约束 #

如果不想改URL结构，可以利用路由约束来区分参数类型——通常id是数字，name是字符串。给ID路由加数字约束，这样只有参数是数字时才会匹配它，字符串参数会自动落到Name路由：

config.Routes.MapHttpRoute(
    name: "IDApi",
    routeTemplate: "api/{controller}/{action}/{id}",
    defaults: new { id = RouteParameter.Optional },
    constraints: new { id = @"\d+" } // 约束id必须是数字
);
config.Routes.MapHttpRoute(
    name: "NameApi",
    routeTemplate: "api/{controller}/{action}/{name}",
    defaults: new { name = RouteParameter.Optional }
);

这样原来的URL就能正常工作：

• api/customer/getByID/5（数字参数匹配IDApi）
• api/customer/searchByName/fawzy（字符串参数不满足IDApi的约束，自动匹配NameApi）

方法三：使用属性路由（推荐） #

Web API 2支持属性路由，这是更现代化、更清晰的方式，直接在Controller和Action上标注路由，不用在全局配置里纠结顺序。

首先在全局配置里启用属性路由：

config.MapHttpAttributeRoutes(); // 要放在传统路由配置之前

然后在你的CustomerController里给每个Action指定路由：

[RoutePrefix("api/customer")]
public class CustomerController : ApiController
{
    // 匹配URL: api/customer/getByID/5
    [Route("getByID/{id:int}")]
    public IHttpActionResult GetByID(int id)
    {
        // 你的业务逻辑
        return Ok();
    }

    // 匹配URL: api/customer/searchByName/fawzy
    [Route("searchByName/{name}")]
    public IHttpActionResult SearchByName(string name)
    {
        // 你的业务逻辑
        return Ok();
    }
}

这种方式每个Action的路由都是明确唯一的，从根源上避免了冲突，也是官方推荐的做法。

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