C#中FluentValidation的用法_C#流畅验证规则教程【推荐】-C#.Net教程-PHP中文网

fluentvalidation 必须显式注册、继承 abstractvalidator 并在构造函数中链式调用 rulefor() 和验证方法，否则静默失效；类名需以 validator 结尾；asp.net core 中需正确配置 addcontrollers().addfluentvalidation() 且类型严格匹配；异步验证须用 mustasync 并接收 cancellationtoken。

c#中fluentvalidation的用法_c#流畅验证规则教程【推荐】

FluentValidation 不是“加个特性就能跑”的验证工具，它必须显式注册、正确继承、链式书写，否则 Validate() 会静默返回 IsValid == true——不是没校验，是根本没被调用或构造失败后退化为空验证器。

验证器类怎么写才不编译失败也不静默失效

核心就一条：必须继承 AbstractValidator<t></t>，且所有 RuleFor() 调用必须放在构造函数中，每条后面必须接至少一个验证方法（如 NotEmpty()、EmailAddress()）。

RuleFor(x => x.Name) 单独写不加后续调用，这条规则完全不生效
表达式只支持简单属性访问：RuleFor(x => x.Email) ✅，RuleFor(x => x.FullName.ToUpper()) ❌（抛 “Expression not supported”）
字符串防空内容必须用 NotEmpty()，NotNull() 对 "" 无效
类名必须以 Validator 结尾（如 UserValidator），否则 ASP.NET Core 自动扫描会跳过它
若构造函数依赖 IOptions<myconfig></myconfig> 等服务，手动 new UserValidator() 可能因 DI 失败导致静默退化；应从容器解析实例

ASP.NET Core 中自动验证不触发的硬坑

装了 FluentValidation.AspNetCore 并调用了 AddFluentValidation()，仍不触发自动验证，问题几乎都出在注册或匹配环节。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

必须调用 services.AddControllers().AddFluentValidation()，光有 AddFluentValidation() 不够
控制器参数类型必须和验证器泛型参数严格一致：接收 User 就得有 UserValidator : AbstractValidator<user></user>
[ApiController] 默认 400 响应依赖此匹配；类型不一致时 ModelState.IsValid 恒为 true，错误只在手动 Validate() 结果里
若同时用了 DataAnnotations，建议清空默认验证器：options.ModelValidatorProviders.Clear()，避免重复触发和消息冲突

RuleFor 链式中断、规则不执行的典型误写

链式不是语法糖，是对象流转：RuleFor() 返回 IRuleBuilder，每个 NotEmpty()、Must() 都返回新实例。断开链 = 丢失上下文 = 规则被丢弃。

❌ 错误写法：RuleFor(x => x.Age); GreaterThan(0); —— 第二行无接收者，编译失败
✅ 正确写法：RuleFor(x => x.Age).GreaterThan(0).LessThan(150);
WithMessage() 必须紧跟在验证方法之后，否则消息不绑定到该规则
嵌套对象验证不能写成 RuleFor(x => x.Address).SetValidator(...)（语法错误），要用 RuleFor(x => x.Address).SetValidator(new AddressValidator())

异步校验 MustAsync() 怎么写才真异步不卡线程

ValidateAsync() 默认是同步执行的。只有显式用了异步规则，才会真正走异步路径。混用同步 I/O 或忽略 CancellationToken 会导致线程池阻塞或死锁。

必须用 MustAsync((model, value, ct) => ...)，漏掉 CancellationToken 参数会导致运行时不传递 token
禁止在 MustAsync 内部调用 .Result 或 .Wait() —— ASP.NET Core 同步上下文中极易死锁
底层仓储不支持 token？可包装为 Task.Run(() => { ... }, ct)，但注意这只是移出同步块，非真正异步 I/O
异步规则里别 throw 异常，用 return false + WithMessage() 控制错误输出