ASP.NET Core过滤器捕获ValidationException后返回原视图的实现问题

我完全懂你的困扰——你不想在每个POST动作里写重复的try/catch，想用全局过滤器捕获ValidationException，把错误塞进ModelState后返回原视图、保留用户输入，但现在要么返回空白页，要么重定向丢失数据。问题的核心是：你处理了异常，但没告诉ASP.NET Core该返回什么结果，它不知道要渲染哪个视图，自然就输出空白了。

下面是修正后的完整解决方案，我会一步步拆解关键点：

第一步：修改ExceptionFilter，添加ViewResult返回逻辑 #

我们需要在捕获到ValidationException后，重新绑定用户提交的表单数据到ViewModel，然后构建ViewResult返回原动作对应的视图，同时带上更新后的ModelState和用户输入值。这里用异步版本的OnExceptionAsync更合适，因为模型绑定是异步操作：

using FluentValidation;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Abstractions;
using Microsoft.AspNetCore.Mvc.ModelBinding;
using Microsoft.AspNetCore.Mvc.ViewFeatures;

public class PostExceptionFilter : ExceptionFilterAttribute
{
    private readonly IModelMetadataProvider _modelMetadataProvider;

    // 注入模型元数据提供者，用来构建ViewDataDictionary
    public PostExceptionFilter(IModelMetadataProvider modelMetadataProvider)
    {
        _modelMetadataProvider = modelMetadataProvider;
    }

    public override async Task OnExceptionAsync(ExceptionContext context)
    {
        if (context.Exception is ValidationException validationEx)
        {
            // 标记异常已处理，清除异常对象
            context.ExceptionHandled = true;
            context.Exception = null;
            context.HttpContext.Response.StatusCode = StatusCodes.Status200OK;

            // 将FluentValidation的错误逐条添加到ModelState
            foreach (var error in validationEx.Errors)
            {
                context.ModelState.AddModelError(error.PropertyName, error.ErrorMessage);
            }

            // 获取当前POST动作对应的ViewModel参数（假设动作的主要参数是表单绑定的ViewModel）
            var viewModelParam = context.ActionDescriptor.Parameters
                .FirstOrDefault(p => p.BindingInfo?.BindingSource is BindingSource.Body or BindingSource.Form);

            if (viewModelParam != null)
            {
                var viewModelType = viewModelParam.ParameterType;
                // 创建ViewModel实例，并重新绑定请求中的表单数据
                var viewModel = Activator.CreateInstance(viewModelType);
                var modelBinderFactory = context.HttpContext.RequestServices.GetRequiredService<IModelBinderFactory>();
                
                // 构建模型绑定上下文
                var bindingContext = DefaultModelBindingContext.CreateBindingContext(
                    context.ActionContext,
                    new ValueProviderCollection(context.HttpContext.Request.ValueProviders),
                    _modelMetadataProvider.GetMetadataForType(viewModelType),
                    null,
                    viewModelParam.Name);

                // 执行模型绑定，还原用户输入
                await modelBinderFactory.CreateBinder(bindingContext).BindModelAsync(bindingContext);

                // 构建ViewResult，返回原动作的视图
                context.Result = new ViewResult
                {
                    // 使用原动作名称作为视图名，确保回到原来的页面
                    ViewName = context.RouteData.Values["action"].ToString(),
                    // 传入包含错误的ModelState和绑定后的ViewModel
                    ViewData = new ViewDataDictionary(_modelMetadataProvider, context.ModelState)
                    {
                        Model = bindingContext.Result.IsModelSet ? bindingContext.Result.Model : viewModel
                    },
                    // 保留TempData（如果需要的话）
                    TempData = context.HttpContext.RequestServices.GetRequiredService<ITempDataDictionary>()
                };
            }
            else
            {
                // 如果没有找到ViewModel参数，返回原视图（不带模型）
                context.Result = new ViewResult
                {
                    ViewName = context.RouteData.Values["action"].ToString(),
                    ViewData = new ViewDataDictionary(_modelMetadataProvider, context.ModelState)
                };
            }

            // 直接返回，不再执行后续基类逻辑
            return;
        }

        // 其他异常的处理逻辑保持不变
        if (context.Exception is UnauthorizedAccessException)
        {
            // 你的自定义处理代码，比如返回403视图
            context.Result = new ForbidResult();
            context.ExceptionHandled = true;
        }

        // 让基类处理未捕获的异常
        await base.OnExceptionAsync(context);
    }
}

第二步：注册过滤器到全局管道 #

在.NET 6+的Program.cs里，你需要把这个过滤器注册到MVC的全局过滤器集合中，同时要注册过滤器本身的依赖（因为它有构造函数注入）：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器和视图服务
builder.Services.AddControllersWithViews();

// 注册过滤器的依赖（IModelMetadataProvider已经由框架默认注册，这里只需要注册过滤器本身）
builder.Services.AddScoped<PostExceptionFilter>();

// 将过滤器添加到全局MVC过滤器
builder.Services.AddControllersWithViews(options =>
{
    options.Filters.Add<PostExceptionFilter>();
});

var app = builder.Build();

// 中间件配置...

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

关键细节解释 #

1. 为什么之前返回空白页？
   当你设置ExceptionHandled = true但没有指定context.Result时，ASP.NET Core没有收到任何要返回的内容，所以会输出空白响应。必须显式设置ViewResult告诉框架要渲染哪个视图。

2. 如何保留用户输入？
   通过IModelBinderFactory重新绑定请求中的表单数据到ViewModel，这样用户之前输入的内容会被还原，不会因为异常丢失。

3. 视图如何显示错误？
   确保你的视图是强类型视图，使用ValidationSummary或ValidationMessageFor辅助方法，它们会自动读取ModelState中的错误并显示：

   @model YourViewModelType
   
   @Html.ValidationSummary(true, "", new { @class = "text-danger" })
   <form asp-action="YourAction">
       <div class="form-group">
           <label asp-for="YourProperty"></label>
           <input asp-for="YourProperty" class="form-control" />
           @Html.ValidationMessageFor(m => m.YourProperty, "", new { @class = "text-danger" })
       </div>
       <button type="submit" class="btn btn-primary">提交</button>
   </form>
   

额外注意事项 #

• 如果你的控制器动作有多个参数，可能需要调整viewModelParam的筛选逻辑（比如根据参数名或自定义特性）。
• 确保FluentValidation的ValidationFailure中的PropertyName和ViewModel的属性名完全匹配，这样错误才能正确对应到表单字段。
• 如果是在服务层抛出ValidationException，确保异常包含完整的错误信息（PropertyName和ErrorMessage）。

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