如何实现PostBack时自动检查ModelState.IsValid，避免重复代码？

嘿，这个问题我太有共鸣了——每次在PostBack方法开头重复写if (!ModelState.IsValid)的检查代码，不仅繁琐还完全违背了*DRY（Don't Repeat Yourself）*原则。下面给你几个实用的自动检查方案，覆盖不同的ASP.NET场景：

这是最通用的解决方案，通过自定义过滤器自动拦截所有需要检查的Action，在执行方法前先验证ModelState。

首先创建一个继承自ActionFilterAttribute的过滤器类：

public class ValidateModelStateAttribute : ActionFilterAttribute
{
    public override void OnActionExecuting(ActionExecutingContext context)
    {
        if (!context.ModelState.IsValid)
        {
            // 针对Web页面PostBack场景：返回原视图并保留错误信息
            if (context.Controller is Controller controller)
            {
                // 尝试从Action参数中获取模型对象，传递回视图
                var model = context.ActionArguments.Values.FirstOrDefault();
                context.Result = controller.View(model);
            }
            // 针对API场景：返回BadRequest并携带错误详情（可根据你的业务调整）
            else
            {
                context.Result = new BadRequestObjectResult(context.ModelState);
            }
        }
    }
}

使用方式： #

• 单个Action启用：在需要检查的Post方法上标记特性

  [HttpPost]
  [ValidateModelState]
  public IActionResult SubmitForm(MyViewModel model)
  {
      // 无需再写ModelState检查，无效时过滤器已拦截并返回视图
      // 直接处理业务逻辑
      return RedirectToAction("Success");
  }
  

• 整个控制器启用：在控制器类上标记特性，该控制器所有Action都会自动检查
• 全局启用（推荐）：在Startup.cs（ASP.NET Core）或Global.asax（ASP.NET MVC）中注册，所有Post请求自动触发检查

  // ASP.NET Core 示例
  services.AddControllersWithViews(options =>
  {
      options.Filters.Add<ValidateModelStateAttribute>();
  });
  

如果你使用的是ASP.NET Core 7及以上版本，端点过滤器是更轻量、灵活的选择，它不需要继承传统的ActionFilter：

public class ValidateModelStateFilter : IEndpointFilter
{
    public async ValueTask<object?> InvokeAsync(EndpointFilterInvocationContext context, EndpointFilterDelegate next)
    {
        // 只针对Post请求做检查（可根据需求调整）
        if (!context.HttpContext.Request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase))
        {
            return await next(context);
        }

        if (!context.ModelState.IsValid)
        {
            // 页面场景：返回原视图并携带错误
            var controller = context.HttpContext.RequestServices.GetService<Controller>();
            if (controller != null)
            {
                var model = context.Arguments.FirstOrDefault();
                return controller.View(model);
            }
            // API场景：返回BadRequest
            return Results.BadRequest(context.ModelState);
        }

        return await next(context);
    }
}

使用方式： #

和ActionFilter类似，可以单个Action标记、控制器标记，或者全局注册：

// 全局注册示例（Program.cs）
builder.Services.AddControllersWithViews(options =>
{
    options.Filters.Add<ValidateModelStateFilter>();
});

如果暂时不想引入过滤器，也可以通过基类控制器封装检查逻辑，减少重复代码：

public class BaseController : Controller
{
    protected bool CheckModelState(object model)
    {
        if (!ModelState.IsValid)
        {
            View(model);
            return false;
        }
        return true;
    }
}

然后让业务控制器继承这个基类：

public class HomeController : BaseController
{
    [HttpPost]
    public IActionResult SubmitForm(MyViewModel model)
    {
        if (!CheckModelState(model)) return View(model);
        // 处理业务逻辑
        return RedirectToAction("Success");
    }
}

总结 #

最推荐的是全局注册Action Filter/端点过滤器，一次配置就能让所有Post请求自动完成ModelState检查，彻底摆脱重复代码的困扰。

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