FluentValidation链式调用需确保每个验证方法返回IRuleBuilder并连续点调用，避免中断；Must适用于简单布尔校验，Custom支持多错误和上下文控制；.NET 6+通过AddFluentValidationAutoValidation()和AddValidatorsFromAssemblyContaining()实现自动注册与验证。
FluentValidation 的 Validator 类怎么写才符合链式调用习惯
FluentValidation 的链式风格不是语法糖，而是靠 RuleFor 返回 IRuleBuilder<t tproperty></t>，后续所有 NotNull()、GreaterThan(0) 这类方法都返回新的 IRuleBuilder 实例，从而支持连续点调用。关键不是“怎么写好看”，而是别提前终止链路。
常见错误是把验证逻辑拆成多行却没接续返回值：
RuleFor(x => x.Age); GreaterThan(0); // ❌ 编译失败：这不是链式，这是孤立调用
正确写法必须一气呵成：
RuleFor(x => x.Age)
.GreaterThan(0)
.LessThan(150)
.WithMessage("年龄必须在 1 到 149 之间");- 每个验证方法（如
NotEmpty()、Must()）都返回IRuleBuilder，中断链就失去上下文 -
WithMessage()和WithName()是链末尾常用收口，但不是必须；不加也能跑，只是错误提示用属性名默认值 - 如果需要复用某段规则（比如邮箱格式），封装成扩展方法比复制粘贴更安全，且保持链式可读性
自定义验证逻辑用 Must() 还是 Custom()
Must() 适合布尔判断型逻辑，比如“密码不能等于用户名”；Custom() 更底层，允许手动添加多个错误、跳过后续规则、甚至访问整个验证上下文 ValidationContext。
例如要同时校验手机号格式和归属地（需查库），用 Custom() 更合适：
RuleFor(x => x.Phone)
.Custom((phone, context) =>
{
if (!Regex.IsMatch(phone, @"^1[3-9]\d{9}$"))
context.AddFailure("手机号格式不正确");
else if (!_areaService.IsSupportedArea(phone))
context.AddFailure("该手机号所属地区暂不支持");
});-
Must(x => x != null && x.Length > 5)简洁，但只能加一条错误；一旦失败，后续同字段的其他Must()不再执行 -
Custom()内部可多次AddFailure()，适合复合校验或需要精细控制错误粒度的场景 - 注意：在
Custom()里抛异常会中断整个验证流程，应只用AddFailure()
.NET 6+ 项目里怎么注册 FluentValidation 并让它自动生效
不手动 new Validator 实例，而是靠 DI 容器自动注入和匹配——核心是调用 AddFluentValidation() 并启用自动发现。
Program.cs 中这样配：
builder.Services.AddFluentValidationAutoValidation(); builder.Services.AddFluentValidationClientsideAdapters(); builder.Services.AddValidatorsFromAssemblyContaining<UserValidator>();
-
AddFluentValidationAutoValidation()让 MVC / Minimal API 在模型绑定后自动触发验证（无需手调Validate()） -
AddValidatorsFromAssemblyContaining<t>()</t>是最常用方式，它会扫描程序集中所有继承AbstractValidator<t></t>的类并注册为单例 - 若 Validator 类不在启动项目里（比如放在 Core 类库），确保传入的是该类库中某个 validator 类型，否则扫描不到
- 不加
AddFluentValidationClientsideAdapters()，前端 JS 校验不会生成 data-val-* 属性（仅影响 ASP.NET Core MVC 的客户端验证）
验证失败时错误信息怎么精准对应到前端字段
错误信息能否正确绑定到前端 input，取决于三件事：属性名拼写、WithName() 覆盖、以及 View Model 层级是否匹配。
比如有个嵌套对象：
public class Order
{
public Address ShippingAddress { get; set; }
}
<p>public class Address
{
public string City { get; set; }
}对应的验证器必须用点号路径声明：
RuleFor(x => x.ShippingAddress.City)
.NotEmpty()
.WithName("收货城市"); // 否则错误仍显示 "ShippingAddress.City"- MVC 默认用属性路径（如
ShippingAddress.City）作为 key，前端asp-validation-for="ShippingAddress.City"才能对上 -
WithName()只影响错误消息里的字段名显示，不影响 key 绑定；真要改 key，得用OverridePropertyName() - 如果用了
[DisplayName]或[Display(Name = "...")]，FluentValidation 默认不识别，必须显式调用WithName()或配置UseAttributeLanguage()
链式本身不难，难的是验证上下文、DI 生命周期、前端字段映射这三层咬合——漏掉任意一层，都会出现“规则写了但没生效”或“报错但找不到哪条规则出的问题”。
