ASP.NET MVC自定义异常过滤器失效：无法显示Exception视图

核心问题分析 #

你的自定义异常过滤器无法正常展示Exception视图，主要是这几个关键原因在作祟：

1. 全局过滤器注册顺序错误
   你先注册了HandleErrorAttribute，再注册CustomExceptionHandlerFilter。ASP.NET MVC的全局过滤器是按注册顺序执行的，HandleErrorAttribute会先捕获异常并标记为已处理，导致你的自定义过滤器根本没机会执行。
2. Ajax请求场景下返回ViewResult不匹配前端预期
   你的New Action是[HttpPost]，正常返回JsonResponse，说明前端是通过Ajax调用的。此时过滤器返回ViewResult，前端Ajax接收的是HTML内容，但不会自动渲染成页面，所以你看不到异常视图。
3. Action上重复标记过滤器
   已经在全局注册了CustomExceptionHandlerFilter，又在Action上添加该特性，属于冗余配置，可能引发执行顺序的混乱。

分步解决方案 #

1. 调整全局过滤器注册顺序 #

把自定义过滤器放在HandleErrorAttribute前面，确保它优先捕获异常：

public static void RegisterGlobalFilters(GlobalFilterCollection filters) { 
    // 先注册自定义过滤器，确保优先处理异常
    filters.Add(new CustomExceptionHandlerFilter()); 
    filters.Add(new HandleErrorAttribute()); 
}

2. 区分Ajax和普通请求，返回对应结果 #

在自定义过滤器中判断请求类型，分别返回Json或View，适配前端场景：

public class CustomExceptionHandlerFilter : FilterAttribute, IExceptionFilter { 
    public void OnException(ExceptionContext filterContext) { 
        filterContext.ExceptionHandled = true; 

        // 判断是否是Ajax请求（依赖请求头带X-Requested-With: XMLHttpRequest）
        if (filterContext.HttpContext.Request.IsAjaxRequest()) {
            // 返回错误Json，让前端弹窗或跳转处理
            filterContext.Result = new JsonResult {
                Data = new { 
                    status = "Error", 
                    message = "An unknown error occurred while processing your request." 
                },
                JsonRequestBehavior = JsonRequestBehavior.AllowGet
            };
        } else {
            // 普通请求返回异常视图
            filterContext.Result = new ViewResult() { ViewName = "Exception" }; 
        }
    } 
}

3. 移除Action上的冗余过滤器标记 #

删除New Action上的[CustomExceptionHandlerFilter]，避免重复执行：

[HttpPost] 
// 移除这一行：[CustomExceptionHandlerFilter] 
public ActionResult New(PurchaseInvMasterModel model) { 
    // ... 原有代码
}

4. 确认Exception视图的位置 #

确保Exception.cshtml放在~/Views/Shared/目录下（全局共享视图），如果放在控制器专属Views目录，需要指定完整路径，比如"~/Views/YourController/Exception.cshtml"。

5. 完善customErrors兜底配置 #

保持Web.config配置的同时，添加兜底跳转，确保极端场景下的错误处理：

<customErrors mode="On" defaultRedirect="~/Home/Error" />

注：因为你的自定义过滤器已标记ExceptionHandled = true，customErrors不会触发，但兜底配置更安全。

额外优化建议 #

• 添加异常日志记录，方便排查问题：

  // 在OnException方法中添加日志
  System.Diagnostics.Trace.WriteLine(filterContext.Exception.ToString());
  // 也可以用NLog、Serilog等专业日志框架
  

• 开发环境下展示具体异常信息：
  在Exception.cshtml中添加调试信息展示：

  @if (HttpContext.Current.IsDebuggingEnabled) {
      <pre class="alert alert-warning">@ViewContext.Exception.ToString()</pre>
  }
  

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