ASP.NET Core中使用Fluent Validation验证子实体非空的最佳实践

我刚好有不少用Fluent Validation处理ASP.NET Core WebAPI数据验证的经验，针对你这个TradeCategory实体的场景，我来分享几个落地的最佳实践步骤，确保插入时关联的Language不为空：

1. 创建TradeCategory专属验证器类 #

首先要为TradeCategory创建对应的Fluent Validation验证器，这里要兼顾两种情况：一是Language对象本身不能为null，二是如果传入了Language对象，它的核心标识属性（比如Id）也得有效，避免出现空对象无实际关联值的情况。

代码示例：

using FluentValidation;

public class TradeCategoryValidator : AbstractValidator<TradeCategory>
{
    public TradeCategoryValidator()
    {
        // 验证Language对象本身非空
        RuleFor(x => x.Language)
            .NotNull()
            .WithMessage("关联的语言信息不能为空");

        // 当Language不为null时，验证其标识ID非空（根据你的Language实体结构调整）
        RuleFor(x => x.Language.Id)
            .NotEmpty()
            .When(x => x.Language != null)
            .WithMessage("语言的标识ID不能为空");
    }
}

2. 在ASP.NET Core中注册验证器服务 #

在你的Startup.cs里，需要把Fluent Validation集成到Mvc服务中，让框架自动在API请求处理时触发验证逻辑。针对.NET Core 2.0，配置如下：

using FluentValidation.AspNetCore;

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 添加Mvc并注册Fluent Validation
        services.AddMvc()
            .AddFluentValidation(fv => 
            {
                // 自动扫描当前程序集中的所有验证器
                fv.RegisterValidatorsFromAssemblyContaining<TradeCategoryValidator>();
                // 可选：禁用默认数据注解验证，只使用Fluent Validation
                fv.RunDefaultMvcValidationAfterFluentValidationExecutes = false;
            });

        // 注册你的EF Core上下文
        services.AddDbContext<YourDbContext>(options => 
            options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
        }

        app.UseMvc();
    }
}

3. 在API控制器中自动触发验证 #

如果你的项目是.NET Core 2.1及以上，给控制器加上[ApiController]特性后，框架会自动检查验证结果并返回错误响应，无需手动处理ModelState；如果是2.0版本，就需要手动检查ModelState。

示例控制器代码：

[Route("api/[controller]")]
[ApiController] // .NET Core 2.1+自动处理验证错误
public class TradeCategoriesController : ControllerBase
{
    private readonly YourDbContext _context;

    public TradeCategoriesController(YourDbContext context)
    {
        _context = context;
    }

    [HttpPost]
    public async Task<IActionResult> PostTradeCategory(TradeCategory tradeCategory)
    {
        // .NET Core 2.0需要手动检查
        // if (!ModelState.IsValid)
        // {
        //     return BadRequest(ModelState);
        // }

        _context.TradeCategories.Add(tradeCategory);
        await _context.SaveChangesAsync();

        return CreatedAtAction(nameof(GetTradeCategory), new { id = tradeCategory.Id }, tradeCategory);
    }
}

额外的实用建议 #

• 优先验证DTO而非实体：如果你的架构有DTO层，建议针对Create/Update的DTO做验证，不要直接验证实体类。比如创建TradeCategoryCreateDto，验证其中的LanguageId非空，再映射到实体，这样更安全也更灵活。
• 嵌套对象验证：如果Language本身有自己的验证规则，可以创建LanguageValidator，然后在TradeCategoryValidator中用SetValidator关联：

  RuleFor(x => x.Language)
      .SetValidator(new LanguageValidator())
      .WithMessage("语言信息不符合要求");
  

• 自定义错误消息：根据业务场景调整错误消息，让前端开发者能快速定位问题。

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