ASP.NET Web API路由参数异常：identifier值不符预期问题排查

核心问题 #

你遇到的identifier值变成hello/bar的原因是请求未匹配到第一条Foo1路由，转而匹配了第二条Foo2这个贪婪的通配符路由，具体触发场景有两种：

1. 路由模板与请求URL的末尾斜杠不匹配：第一条路由模板是foo/{identifier}/bar/（带末尾斜杠），若请求URL是/foo/hello/bar（不带末尾斜杠），ASP.NET Web API默认不会忽略末尾斜杠差异，导致Foo1匹配失败，请求落入Foo2路由。而Foo2的{*identifier}是通配符路由，会贪婪捕获hello/bar整个后续路径作为identifier的值。
2. 路由匹配优先级冲突：即使请求URL带末尾斜杠，也可能因路由约束缺失，导致Foo1未优先匹配POST请求。Web API传统路由表默认不限制HTTP方法，若Foo2模板能覆盖请求路径，就会抢占匹配。

修复方案 #

方案1：统一末尾斜杠 #

将Foo1的路由模板改为不带末尾斜杠的形式，与请求URL保持一致：

httpConfiguration.Routes.MapHttpRoute("Foo1", "foo/{identifier}/bar", new
{
    controller = "Foo",
    action = nameof(Foo.Bar)
});

或确保所有请求/foo/{identifier}/bar时都带上末尾斜杠。

方案2：给Foo1添加HTTP方法约束 #

明确指定Foo1仅匹配POST请求，避免被其他路由抢占：

httpConfiguration.Routes.MapHttpRoute("Foo1", "foo/{identifier}/bar/", new
{
    controller = "Foo",
    action = nameof(Foo.Bar)
}, constraints: new { httpMethod = new HttpMethodConstraint(HttpMethod.Post) });

方案3：改用属性路由（推荐） #

直接在控制器方法上标注路由，属性路由匹配优先级高于传统路由表，可彻底避免冲突：

[HttpPost]
[ScopeAuthorize(SomeScope)]
[Route("foo/{identifier}/bar")] // 可根据需求添加末尾斜杠
public HttpResponseMessage Bar(string identifier, [FromBody] SomeDto dto)
{
    Console.WriteLine(identifier);
}

使用属性路由前，需在Web API配置中启用：

config.MapHttpAttributeRoutes();

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