ASP.NET MVC 5 配置catch-all路由处理缺失必填参数返回404方案

解决方案 #

方案1：仅通过路由配置实现（完全无需修改业务Action代码）

你可以拆分路由规则，通过路由约束区分「需要必填id」和「不需要id」的请求，直接将缺id的合法动作请求导向404：

1. 首先新增一条带id约束的路由，仅当请求携带合法int类型id时才会命中，可正常对接你现有非空int参数的Action：

routes.MapRoute(
    name: "ActionWithRequiredId",
    url: "{controller}/{action}/{id}",
    defaults: new { controller = "Home", action = "Index" },
    // 约束id必须为正整数，可根据业务调整数值匹配规则
    constraints: new { id = @"\d+" }
);

2. 新增一条匹配无id后缀请求的路由，直接指向你自定义的404处理动作：

routes.MapRoute(
    name: "MissingIdTo404",
    url: "{controller}/{action}",
    defaults: new { controller = "Error", action = "NotFound" }
);

3. 原有默认路由可移除或放到最后，兜底处理/、/Home这类不需要指定动作和id的常规请求。

如果部分Action确实不需要id参数（比如Index），可以在路由最前面加对应专属路由，或者写自定义路由约束过滤这些动作，避免误拦截。自定义约束示例：

public class NeedIdConstraint : IRouteConstraint
{
    // 启动时提前扫描所有Controller的Action，将带非空int id参数的动作存入该静态字典
    private static readonly HashSet<Tuple<string, string>> _needIdActions = new HashSet<Tuple<string, string>>();

    public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection)
    {
        var controller = values["controller"].ToString().ToLower();
        var action = values["action"].ToString().ToLower();
        return _needIdActions.Contains(Tuple.Create(controller, action));
    }
}

将约束加到第一条路由即可：constraints: new { id = @"\d+", needId = new NeedIdConstraint() }

方案2：全局过滤器兜底（无需修改路由和业务代码）

如果不想调整路由配置，可以加全局Action过滤器统一捕获该类参数缺失异常，直接转404：

public class MissingIdHandleFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext filterContext)
    {
        var paramList = filterContext.ActionDescriptor.GetParameters();
        foreach (var param in paramList)
        {
            if (param.ParameterType == typeof(int) && param.ParameterName == "id")
            {
                if (!filterContext.ActionParameters.TryGetValue("id", out var idVal) || idVal == null)
                {
                    filterContext.Result = new HttpNotFoundResult();
                    return;
                }
            }
        }
    }

    public void OnActionExecuted(ActionExecutedContext filterContext)
    {
        if (filterContext.Exception is ArgumentException ae 
            && ae.Message.Contains("null entry for parameter 'id' of non-nullable type 'System.Int32'"))
        {
            filterContext.ExceptionHandled = true;
            filterContext.Result = new HttpNotFoundResult();
            filterContext.HttpContext.Response.StatusCode = 404;
        }
    }
}

在FilterConfig.RegisterGlobalFilters中注册该过滤器即可全局生效。

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