如何在ASP.NET MVC中针对有效路由返回405而非404错误？

这个问题我之前也遇到过，硬编码每个路由的方式确实太繁琐了，每次加新Action都要手动加对应的405处理，完全不符合DRY原则。下面给你两个更优雅的全局解决方案，不需要重复代码，新增Action时也无需额外配置：

方案1：自定义Web API Action选择器（推荐） #

这个方案直接介入ASP.NET Web API的Action选择流程，当路由匹配但HTTP方法不匹配时，自动返回405错误并带上允许的方法头，完全自动化：

步骤1：创建自定义Action选择器 #

using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Reflection;
using System.Web.Http;
using System.Web.Http.Controllers;
using System.Web.Http.Routing;

public class CustomActionSelector : ApiControllerActionSelector
{
    public override HttpActionDescriptor SelectAction(HttpControllerContext controllerContext)
    {
        try
        {
            // 先尝试用默认逻辑选择Action
            return base.SelectAction(controllerContext);
        }
        catch (HttpResponseException ex)
        {
            // 如果默认逻辑返回404，检查是否是方法不匹配导致的
            if (ex.Response.StatusCode == HttpStatusCode.NotFound)
            {
                var routeData = controllerContext.RouteData;
                var controllerDescriptor = controllerContext.ControllerDescriptor;
                
                // 找到当前控制器下所有匹配该路由模板的Action
                var matchingActions = controllerDescriptor.ControllerType.GetMethods()
                    .Where(method => 
                        method.GetCustomAttributes<RouteAttribute>()
                              .Any(attr => attr.Template == routeData.Values["action"]?.ToString()))
                    .ToList();

                if (matchingActions.Any())
                {
                    // 收集所有允许的HTTP方法
                    var allowedMethods = new HashSet<string>();
                    foreach (var action in matchingActions)
                    {
                        var httpMethodAttrs = action.GetCustomAttributes<HttpMethodAttribute>();
                        allowedMethods.UnionWith(httpMethodAttrs.SelectMany(attr => attr.HttpMethods.Select(m => m.Method)));
                    }

                    // 构造405响应，必须包含Allow头
                    var response = new HttpResponseMessage(HttpStatusCode.MethodNotAllowed);
                    response.Headers.Allow.AddRange(allowedMethods.Select(m => new HttpMethod(m)));
                    throw new HttpResponseException(response);
                }
            }
            
            // 如果是真的404，抛出原异常
            throw;
        }
    }
}

步骤2：注册自定义选择器 #

在WebApiConfig.cs的Register方法中，替换默认的Action选择器：

public static void Register(HttpConfiguration config)
{
    // ... 其他配置代码 ...
    
    // 替换为自定义Action选择器
    config.Services.Replace(typeof(IHttpActionSelector), new CustomActionSelector());
}

方案2：全局405处理Action + 路由匹配检查 #

如果你不想修改Action选择逻辑，可以用这个更简单的方案：创建一个全局的405处理Action，先判断路由是否存在，再返回对应状态码：

步骤1：创建错误处理控制器 #

using System.Linq;
using System.Web;
using System.Web.Mvc;
using System.Web.Routing;

public class ErrorController : Controller
{
    // 路由优先级设为最低，最后匹配
    [Route("{*url}", Order = int.MaxValue)]
    public ActionResult Handle405()
    {
        var httpContext = new HttpContextWrapper(HttpContext);
        var routeData = RouteTable.Routes.GetRouteData(httpContext);
        
        // 如果路由不存在，返回404
        if (routeData == null)
        {
            return new HttpNotFoundResult();
        }

        // 收集该路由允许的所有HTTP方法
        var allowedMethods = new List<string>();
        foreach (var route in RouteTable.Routes)
        {
            var methodConstraint = route.Constraints.Values
                .OfType<HttpMethodConstraint>()
                .FirstOrDefault();
            
            if (methodConstraint != null && route.Url == routeData.Route.Url)
            {
                allowedMethods.AddRange(methodConstraint.AllowedMethods);
            }
        }

        // 设置Allow响应头
        Response.Headers.Add("Allow", string.Join(", ", allowedMethods.Distinct()));
        return new HttpStatusCodeResult(405, "Method Not Allowed");
    }
}

步骤2：确保路由配置正确 #

确保你的路由规则中，这个全局路由的Order是最大的，这样只会在所有其他路由都匹配失败时才会触发。

注意事项 #

• 405响应必须包含Allow头，这是HTTP规范的要求，告诉客户端哪些方法是被允许的。
• 方案1更适合Web API场景，方案2适合传统MVC控制器场景。
• 两种方案都不需要在每个控制器中重复写代码，新增Action时自动生效。

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