Web API路由问题：重载GET方法致其他动词返回405 Method Not Allowed

这个问题的核心是路由模板的匹配优先级冲突：当你添加了无约束的{userName} GET路由后，Web API的路由系统会优先匹配这个模板，哪怕请求是DELETE/PUT方法——因为路由匹配是先看URL模板是否符合，再检查HTTP方法是否对应。比如DELETE api/UserAccounts/5会被匹配到{userName}的GET路由，但这个路由只绑定了GET方法，所以返回405错误。

下面给你两种可行的解决方案：

方案1：给用户名查询使用独立的路由模板（最推荐） #

最简单的方式是给按用户名查询的接口换一个明确的路由前缀，彻底避免和ID路由冲突，比如：

// GET: api/UserAccounts/by-username/JohnDoe123
[HttpGet]
[ResponseType(typeof(UserAccount))]
[Route("~/api/UserAccounts/by-username/{userName}")]
public async Task<IHttpActionResult> GetUserAccount(string userName) 
{ 
    // 你的业务逻辑
}

这样，ID相关的路由（GET/DELETE/PUT）依然使用api/UserAccounts/{id:int}，POST使用api/UserAccounts，所有路由都不会冲突，其他操作自然恢复正常。

方案2：使用自定义路由约束区分ID和用户名 #

如果不想修改路由模板，可以通过自定义路由约束来让数字ID优先匹配到int参数的方法，非数字（或无法转为int的字符串）匹配到用户名方法：

第一步：创建自定义路由约束 #

public class NonNumericConstraint : IHttpRouteConstraint
{
    public bool Match(HttpRequestMessage request, IHttpRoute route, string parameterName, IDictionary<string, object> values, HttpRouteDirection routeDirection)
    {
        if (values.TryGetValue(parameterName, out var value) && value is string strValue)
        {
            // 如果无法转为int，就匹配这个约束
            return !int.TryParse(strValue, out _);
        }
        return false;
    }
}

第二步：在WebApiConfig中注册约束 #

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 注册自定义约束
        config.RouteConstraints.Add("nonnumeric", new NonNumericConstraint());

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

        // 其他配置...
    }
}

第三步：给路由添加约束和优先级 #

给ID的路由设置更高的优先级（RouteOrder越小越先匹配），给用户名路由添加自定义约束：

// 优先匹配数字ID的GET方法，RouteOrder设为0（默认优先级）
[HttpGet]
[ResponseType(typeof(UserAccount))]
[Route("~/api/UserAccounts/{id:int}", RouteOrder = 0)]
public async Task<IHttpActionResult> GetUserAccount(int id) { ... }

// 只有非数字的参数才会匹配这个路由，优先级设为1（低于ID路由）
[HttpGet]
[ResponseType(typeof(UserAccount))]
[Route("~/api/UserAccounts/{userName:nonnumeric}", RouteOrder = 1)]
public async Task<IHttpActionResult> GetUserAccount(string userName) { ... }

这样，当请求api/UserAccounts/5时会优先匹配到int参数的GET方法，而api/UserAccounts/JohnDoe123会匹配到用户名方法，DELETE/PUT请求也能正确匹配到对应的int参数方法。

关于POST的405问题 #

当你给POST添加属性路由后依然报错，大概率是模型验证失败或者路由匹配异常：

• 检查请求Body是否符合UserAccount模型的结构，是否有必填字段未传；
• 在POST方法开头添加日志或断点，确认请求是否进入方法，若未进入，检查是否有其他路由干扰；
• 确保POST的路由~/api/UserAccounts没有和其他同模板的路由冲突（比如GET的~/api/UserAccounts是允许共存的，因为HTTP方法不同）。

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