使用MediatR与Fluent Validation验证UpdateBasketRequest时遇空值错误

问题背景 #

使用Fluent Validation验证UpdateBasketRequest时出现验证错误：控制器从路由获取BasketId后手动赋值给请求对象的字段，但Fluent Validation在赋值操作前就完成了验证，导致BasketId为空触发非空规则。

核心相关代码如下：

UpdateBasketRequest #

public class UpdateBasketRequest : IRequest<UpdateBasketResponse>
{
   public string BasketId; // 无get/set的字段
   public List<BasketItemDto> Items { get; set; }
}

控制器代码 #

[HttpPost]
[Route("{id}")]       
public async Task<IActionResult> UpdateBasket([FromRoute] string id, [FromBody] UpdateBasketRequest request)
{
   request.BasketId = id; // 赋值在自动验证之后执行
   return await this.HandleRequest<UpdateBasketRequest, UpdateBasketResponse>(request);
}

UpdateBasketValidator #

public class UpdateBasketValidator : AbstractValidator<UpdateBasketRequest>
{
   public UpdateBasketValidator()
   {
      this.RuleFor(x => x.BasketId).NotNull().NotEmpty().WithMessage("Id cannot be empty or null");
   }
}

可行解决方案 #

方案1：通过模型绑定直接赋值BasketId（推荐） #

这是最符合ASP.NET Core规范的方案，无需手动赋值，从根源避免验证时机问题：

1. 将UpdateBasketRequest的BasketId字段改为带get/set的属性，并指定路由绑定来源：

public class UpdateBasketRequest : IRequest<UpdateBasketResponse>
{
   [FromRoute(Name = "id")] // 绑定路由中的id参数
   public string BasketId { get; set; }
   public List<BasketItemDto> Items { get; set; }
}

2. 修改控制器方法，移除手动赋值逻辑，模型绑定会自动完成赋值：

[HttpPost]
[Route("{id}")]       
public async Task<IActionResult> UpdateBasket([FromBody] UpdateBasketRequest request)
{
   // 此时BasketId已从路由绑定赋值，验证可正常执行
   return await this.HandleRequest<UpdateBasketRequest, UpdateBasketResponse>(request);
}

若项目需要混合绑定路由和Body参数，可在Program.cs中配置支持：

builder.Services.AddControllers(options =>
{
   options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
});

方案2：手动触发验证，在赋值后执行 #

如果无法修改请求对象结构，可关闭自动验证，手动控制验证时机：

1. 向控制器注入验证器：

private readonly IValidator<UpdateBasketRequest> _updateBasketValidator;

public BasketController(IValidator<UpdateBasketRequest> updateBasketValidator, /* 其他依赖 */)
{
   _updateBasketValidator = updateBasketValidator;
}

2. 修改控制器方法，先赋值再手动验证：

[HttpPost]
[Route("{id}")]
[DisableRequestValidation] // 禁用自动验证
public async Task<IActionResult> UpdateBasket([FromRoute] string id, [FromBody] UpdateBasketRequest request)
{
   request.BasketId = id;

   // 手动执行验证
   var validationResult = await _updateBasketValidator.ValidateAsync(request);
   if (!validationResult.IsValid)
   {
      return ValidationProblem(validationResult.ToDictionary());
   }

   return await this.HandleRequest<UpdateBasketRequest, UpdateBasketResponse>(request);
}

方案3：临时调整验证规则（不推荐） #

若需临时规避，可修改验证规则降低严谨性，但不建议长期使用：

public class UpdateBasketValidator : AbstractValidator<UpdateBasketRequest>
{
   public UpdateBasketValidator()
   {
      // 仅当BasketId不为null时验证非空
      this.RuleFor(x => x.BasketId)
          .NotEmpty().WithMessage("Id cannot be empty")
          .When(x => x.BasketId != null);
   }
}

额外注意点 #

确保BasketItemDto的验证器被正确注册，并在UpdateBasketValidator中添加对子集合的验证：

public class UpdateBasketValidator : AbstractValidator<UpdateBasketRequest>
{
   public UpdateBasketValidator()
   {
      this.RuleFor(x => x.BasketId).NotNull().NotEmpty().WithMessage("Id cannot be empty or null");
      // 验证Items集合中的每个元素
      this.RuleForEach(x => x.Items).SetValidator(new BasketValidator());
   }
}

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