ASP.NET MVC5中HandleError过滤器无法捕获HttpException的问题

我之前也碰到过一模一样的问题，核心原因是：带HTTP状态码的HttpException会被ASP.NET的customErrors模块优先拦截，直接跳转到你配置的静态错误页，完全绕过了MVC的HandleErrorAttribute过滤器。而像NullReferenceException这类普通异常不会触发customErrors的状态码拦截逻辑，所以能被MVC过滤器正常处理。

下面给你几个可行的解决方案，按推荐程度排序：

方案1：调整customErrors配置，指向MVC错误Action（最简洁） #

修改web.config中的customErrors节点，把特定状态码的跳转指向MVC控制器的Action，而不是静态页面，同时设置redirectMode="ResponseRewrite"来保留原始请求的状态码：

<customErrors mode="On" redirectMode="ResponseRewrite">
  <!-- 针对404错误指向Error控制器的NotFound方法 -->
  <error statusCode="404" redirect="~/Error/NotFound" />
  <!-- 针对500错误指向Error控制器的ServerError方法 -->
  <error statusCode="500" redirect="~/Error/ServerError" />
  <!-- 其他状态码可以按需添加 -->
</customErrors>

然后创建一个ErrorController，实现对应的Action：

public class ErrorController : Controller
{
    public ActionResult NotFound()
    {
        Response.StatusCode = 404;
        // 使用你已有的Error视图，或者单独创建NotFound视图
        return View("Error", new HandleErrorInfo(new HttpException(404, "Not found!"), "Test", "Test"));
    }

    public ActionResult ServerError()
    {
        Response.StatusCode = 500;
        return View("Error");
    }
}

这样处理后，抛出HttpException(404, ...)时，会直接进入Error/NotFound Action，渲染你自定义的Error视图，同时保留正确的HTTP状态码。

方案2：自定义异常过滤器，强制捕获HttpException #

如果不想修改customErrors的跳转配置，可以自定义一个继承HandleErrorAttribute的过滤器，手动拦截HttpException，并标记异常已处理，跳过customErrors的拦截：

第一步：创建自定义过滤器 #

public class CustomHandleErrorAttribute : HandleErrorAttribute
{
    public override void OnException(ExceptionContext filterContext)
    {
        // 如果异常已经被处理，或者自定义错误未开启，直接返回
        if (filterContext.ExceptionHandled || !filterContext.HttpContext.IsCustomErrorEnabled)
        {
            return;
        }

        // 检查是否是HttpException
        var httpException = filterContext.Exception as HttpException;
        if (httpException != null)
        {
            // 设置响应状态码
            filterContext.HttpContext.Response.StatusCode = httpException.GetHttpCode();
            // 指定要使用的错误视图
            ViewName = "Error";
        }

        // 调用基类方法处理
        base.OnException(filterContext);

        // 标记异常已处理，防止后续模块（比如customErrors）再次拦截
        filterContext.ExceptionHandled = true;
        // 清除原有响应内容
        filterContext.HttpContext.Response.Clear();
        // 手动返回错误视图
        filterContext.Result = new ViewResult
        {
            ViewName = ViewName,
            ViewData = new ViewDataDictionary<HandleErrorInfo>(
                new HandleErrorInfo(
                    filterContext.Exception,
                    filterContext.RouteData.Values["controller"].ToString(),
                    filterContext.RouteData.Values["action"].ToString()
                )
            )
        };
        // 关键：跳过IIS的自定义错误拦截
        filterContext.HttpContext.Response.TrySkipIisCustomErrors = true;
    }
}

第二步：注册自定义过滤器 #

打开Global.asax.cs，在Application_Start方法中替换默认的HandleErrorAttribute：

protected void Application_Start()
{
    AreaRegistration.RegisterAllAreas();
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
    RouteConfig.RegisterRoutes(RouteTable.Routes);
    BundleConfig.RegisterBundles(BundleTable.Bundles);

    // 移除默认的HandleError过滤器，添加自定义的
    var defaultHandleError = GlobalFilters.Filters.First(f => f.Instance is HandleErrorAttribute);
    GlobalFilters.Filters.Remove(defaultHandleError);
    GlobalFilters.Filters.Add(new CustomHandleErrorAttribute());
}

第三步：调整web.config配置 #

把customErrors的redirectMode设为ResponseRewrite，避免跳转丢失上下文：

<customErrors mode="On" redirectMode="ResponseRewrite" />

方案3：处理IIS的httpErrors拦截（针对IIS 7+） #

如果你的应用部署在IIS 7及以上版本，可能还需要配置system.webServer下的httpErrors节点，因为IIS的原生错误处理会覆盖ASP.NET的customErrors：

<system.webServer>
  <httpErrors errorMode="Custom" existingResponse="PassThrough">
    <!-- 移除IIS默认的404、500错误配置 -->
    <remove statusCode="404" subStatusCode="-1" />
    <remove statusCode="500" subStatusCode="-1" />
    <!-- 让MVC的过滤器处理这些错误 -->
  </httpErrors>
</system.webServer>

existingResponse="PassThrough"的作用是让ASP.NET生成的响应（比如MVC返回的错误视图）直接传递给客户端，而不是被IIS替换成原生错误页。

验证测试 #

完成配置后，再次调用Test Action抛出HttpException(404, "Not found!")，应该就能正常渲染你自定义的Error视图，显示异常消息和状态码了。

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