AspNet MVC Web Api中ActionName与Route属性的差异、选择及优先级问题

嗨，这个问题问得很到位！在ASP.NET MVC Web API里，ActionName和Route属性确实都能实现Action别名，但它们的定位和用法差异还挺明显的，我给你拆解清楚：

• ActionName属性：它的作用是重命名Action的逻辑标识，并没有直接定义路由规则。它只是告诉框架：当匹配Action的时候，别用方法名ObtainValue了，用我指定的别名（比如GetValue）来匹配。它依赖于已有的路由模板（比如默认的api/{controller}/{action}），只是把模板里的{action}段替换成你设置的别名。
• Route属性：它是直接自定义路由模板，完全不依赖默认路由结构。你可以直接给Action指定一个独立的URL路径，比如[Route("api/values/fetch")]，不管方法名是什么，只要请求这个URL就能命中该Action。它还支持添加参数、路由约束等更灵活的配置，比如[Route("api/values/fetch/{id:int}")]来限制id必须是整数。

• 如果你的需求只是给Action换个更友好的别名，同时想沿用项目里的默认路由结构（比如保持api/控制器名/别名的格式），那用ActionName就够了，简单省心，不用改动路由模板。
• 如果需要更灵活的路由规则——比如想缩短URL路径、添加参数约束、或者让多个Action共享特定的路由前缀，那Route属性是更好的选择。它能让你完全掌控这个Action的路由规则，不受默认路由的限制。

当你给同一个Action同时加上ActionName和Route属性时，Route属性的优先级更高。因为Route是直接定义了具体的匹配路径，框架会优先匹配这个自定义路由，而ActionName只是改变了Action的逻辑名称，不会覆盖Route指定的路由规则。

举个代码例子：

[ActionName("GetValue")]
[Route("api/custom/fetch-value")]
public IHttpActionResult ObtainValue()
{
    // 业务逻辑
    return Ok("Success");
}

这个时候，只有访问api/custom/fetch-value才能触发这个Action，而不是默认路由下的api/你的控制器名/GetValue——因为Route直接指定了路由路径，优先级更高。

内容的提问来源于stack exchange，提问作者Victor Hugo Terceros