FluentValidation 中 Validate 方法返回 ValidationResult，须检查 IsValid 而非直接当 bool 用；字符串/集合校验应优先用 NotEmpty()；ASP.NET Core 需注册 AddFluentValidation 才同步 ModelState；自定义谓词须为静态方法或不捕获外部变量。
FluentValidation 中 Validate 方法返回值别直接当 bool 用
很多人写 validate 后立刻 if (!result.isvalid)，结果发现空对象、null 属性或自定义规则失败时逻辑没走对——因为 validate 返回的是 validationresult，它不重载隐式转换，!result.isvalid 没问题，但容易误以为 result 自身能当布尔用（比如传给 assert.istrue(result) 会编译失败）。
实操建议：
- 始终检查
result.IsValid，而不是把result当布尔值参与逻辑运算 - 调试时直接打印
result.Errors，里面是ValidationFailure列表，每个含PropertyName、ErrorMessage和AttemptedValue - 如果要快速失败（fail-fast），用
ValidateAndThrow()，但它抛的是ValidationException，不是ArgumentException，上层要 catch 住这个类型
自定义验证器里调 NotNull() 和 NotEmpty() 的区别很关键
对字符串或集合属性，NotNull() 只防 null，NotEmpty() 防 null 且防空字符串（""）或空集合（new List）。但很多人混用，导致前端传了空字符串却校验通过。
实操建议：
- 字符串字段想禁止空内容：用
NotEmpty()，别只用NotNull() - 集合字段（如
IEnumerable）要确保至少一个元素：用NotEmpty()；若允许空集合但不允许 null，才用NotNull() -
NotNull()对值类型（如int?）有意义，对int直接无效（编译不过）
在 ASP.NET Core 中启用 FluentValidation 后，ModelState 不自动同步错误？
默认情况下，FluentValidation 的错误不会自动注入 MVC 的 ModelState，你看到 ModelState.IsValid == true，但 Validate() 返回了错误——这是因为没注册适配器。
实操建议：
- 在
Program.cs里必须加services.AddControllers().AddFluentValidation(...)，不是只加AddFluentValidationClientsideAdapters() - 确保你的验证器类名以
Validator结尾（如UserValidator），且继承AbstractValidator，否则自动发现机制可能漏掉 - 如果用了
[ApiController]，它默认开启模型验证短路（400 自动返回），但前提是验证器被正确注册并匹配到 Action 参数类型
RuleFor(x => x.Name).Must(BeValidName) 里的 BeValidName 函数不能捕获外部变量
写成 RuleFor(x => x.Name).Must(name => name.Length > 2 && name.All(char.IsLetter)) 没问题，但一旦提取成独立方法并引用闭包变量（比如从 DI 容器拿服务、或访问局部 var prefix = "USR_"），运行时会报 NotSupportedException：FluentValidation 在构建表达式树时无法序列化委托引用。
实操建议：
- 自定义谓词函数必须是静态方法，或至少不捕获任何外部作用域变量
- 需要依赖服务（如查数据库）？改用
MustAsync+IValidatorOptions注入IServiceProvider，再通过context.GetRequiredService获取() - 简单逻辑别封装：直接写内联 lambda，比拆函数更安全、更易读
最常被忽略的点是：FluentValidation 的规则链在构造时就编译成表达式树，它不是运行时动态解释的。所以任何“看起来能跑”的闭包写法，上线后可能在某些场景下静默失效。
