如何使用全局异常过滤器向特定Controller Action视图传递错误消息

实现方案（基于ASP.NET Core MVC） #

推荐使用**异常过滤器（Exception Filter）**实现，它处于MVC请求管道内，可以直接获取当前请求的Action、Controller上下文信息，无需跳转通用错误页，直接返回当前Action对应的视图。

步骤1：自定义异常过滤器 #

实现IAsyncExceptionFilter接口，核心逻辑是捕获异常后标记为已处理，构造对应视图的返回结果：

// 自定义异常过滤器
public class CustomViewExceptionFilter : IAsyncExceptionFilter
{
    public Task OnExceptionAsync(ExceptionContext context)
    {
        // 标记异常已处理，不会触发全局异常中间件的通用错误页跳转
        context.ExceptionHandled = true;

        // 自定义错误消息，可根据异常类型做差异化处理
        string errorMessage = $"操作失败：{context.Exception.Message}";

        // 将异常存入HttpContext.Items，可在当前请求的任意位置获取（包括Controller的finally块、视图等）
        context.HttpContext.Items["RequestException"] = context.Exception;

        // 构造当前Action对应的视图返回结果
        context.Result = new ViewResult
        {
            // 直接使用当前请求的Action名作为视图名，返回原视图
            ViewName = context.ActionDescriptor.RouteValues["action"],
            ViewData = new ViewDataDictionary(new EmptyModelMetadataProvider(), context.ModelState)
            {
                // 错误消息存入ViewData，视图可直接读取
                ["ErrorMsg"] = errorMessage,
                // 保留用户提交的表单数据，回显到视图
                Model = context.ActionArguments.FirstOrDefault().Value
            }
        };
        return Task.CompletedTask;
    }
}

步骤2：注册过滤器 #

根据需求选择注册方式：

• 全局生效：所有Controller的Action都自动应用该异常处理逻辑，在Program.cs中添加配置：

builder.Services.AddControllersWithViews(options =>
{
    options.Filters.Add<CustomViewExceptionFilter>();
});

• 按需生效：只给指定Controller/Action应用，把过滤器改造成特性形式：

// 继承Attribute即可作为特性标注
public class CustomViewExceptionFilterAttribute : Attribute, IAsyncExceptionFilter
{
    // 上述OnExceptionAsync逻辑保持不变
}

使用时直接在Controller或Action上标注即可：

[CustomViewExceptionFilter]
public class TestController : Controller
{
    // Action代码无需再写try/catch
    [HttpPost]
    public IActionResult DoSomething(Some thing)
    {
        return View(message);
    }
}

异常信息获取方式 #

• 视图中直接读取@ViewData["ErrorMsg"]展示错误提示
• Controller中如果需要获取异常，可在finally块中从HttpContext.Items["RequestException"]读取
• 如果是AJAX请求，可在过滤器中判断Request.Headers["X-Requested-With"] == "XMLHttpRequest"，直接返回Json结果而非视图。

注意事项 #

如果项目已配置全局异常中间件UseExceptionHandler，需确保过滤器中已将context.ExceptionHandled设为true，避免重复处理跳转到通用错误页。

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