ASP.NET Core 6 Web API属性验证未返回全部错误的解决办法

场景1：同时返回特性验证与IValidatableObject的错误 #

默认情况下，[ApiController]会在特性验证失败时直接返回BadRequest，不会执行IValidatableObject.Validate()方法。要收集所有错误，需确保两种验证逻辑都执行并合并结果，以下是两种原生实现方式：

方式1：禁用自动验证，手动触发全量验证 #

1. 在Program.cs中关闭自动验证过滤器：

   builder.Services.Configure<ApiBehaviorOptions>(options =>
   {
       options.SuppressModelStateInvalidFilter = true;
   });
   

2. 创建控制器基类，封装全量验证逻辑：

   [ApiController]
   [Route("api/[controller]")]
   public abstract class BaseApiController : ControllerBase
   {
       protected IActionResult ValidateModel<T>(T model)
       {
           // 先收集特性验证错误
           var isValid = ModelState.IsValid;
   
           // 执行IValidatableObject验证（如果实现了该接口）
           if (model is IValidatableObject validatable)
           {
               var validationResults = validatable.Validate(new ValidationContext(model));
               foreach (var result in validationResults)
               {
                   foreach (var memberName in result.MemberNames)
                   {
                       ModelState.AddModelError(memberName, result.ErrorMessage);
                   }
               }
           }
   
           return ModelState.IsValid ? Ok() : BadRequest(ModelState);
       }
   }
   

3. 在业务控制器的Action中调用验证：

   public class MyController : BaseApiController
   {
       [HttpPost]
       public IActionResult Create([FromBody] MyDto dto)
       {
           var validationResult = ValidateModel(dto);
           if (validationResult is BadRequestObjectResult)
           {
               return validationResult;
           }
   
           // 执行业务逻辑
           return Ok("创建成功");
       }
   }
   

方式2：自定义验证器，强制执行IValidatableObject验证 #

1. 实现自定义IModelValidator，确保IValidatableObject的验证始终被执行：

   public class AlwaysRunValidatableObjectValidator : IModelValidator
   {
       public IEnumerable<ModelValidationResult> Validate(ModelValidationContext context)
       {
           if (context.Model is IValidatableObject validatable)
           {
               var results = validatable.Validate(context.ValidationContext);
               return results.SelectMany(r => r.MemberNames.Select(member => 
                   new ModelValidationResult(member, r.ErrorMessage)));
           }
           return Enumerable.Empty<ModelValidationResult>();
       }
   }
   

2. 在Program.cs中注册自定义验证器，确保它优先执行：

   builder.Services.AddMvc(options =>
   {
       options.ModelValidatorProviders.Insert(0, new AlwaysRunValidatableObjectValidator());
   });
   

   此方式下，无论特性验证是否通过，IValidatableObject.Validate()都会被调用，所有错误都会被收集到ModelState中，最终由[ApiController]自动返回。

场景2：嵌套集合中同时返回子对象错误与集合null检查错误 #

默认框架会优先验证集合中的子对象，若子对象存在错误，可能跳过集合本身的属性验证。要同时返回两种错误，可结合场景1的全量验证方案，通过IValidatableObject实现集合的null检查（替代属性验证特性），确保验证逻辑总是执行：

1. 定义Parent和Child DTO：

   public class ParentDto : IValidatableObject
   {
       public ICollection<ChildDto> Children { get; set; }
   
       public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
       {
           // 检查集合中是否包含null元素
           if (Children != null)
           {
               for (int i = 0; i < Children.Count; i++)
               {
                   if (Children.ElementAt(i) == null)
                   {
                       yield return new ValidationResult(
                           $"第{i+1}个子对象不能为null", 
                           new[] { $"{nameof(Children)}[{i}]" });
                   }
               }
           }
   
           // 其他复杂验证逻辑
           yield break;
       }
   }
   
   public class ChildDto
   {
       [Required(ErrorMessage = "子对象名称不能为空")]
       [MaxLength(10, ErrorMessage = "子对象名称不能超过10个字符")]
       public string Name { get; set; }
   }
   

2. 应用场景1中的任意一种全量验证方案，确保：

   • 子对象的特性验证错误被收集
   • Parent的Validate()方法总是执行，集合null检查错误被收集

这样，当请求中同时存在无效Child和null元素时，两种错误都会出现在响应的ModelState中。

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