IValidatableObject 是用于跨属性和业务逻辑验证的接口，补充 DataAnnotations 的单字段限制；它同步执行、不支持客户端验证，需手动指定 MemberNames 定位错误，且不可抛异常或异步操作。
什么是 IValidatableObject，它和 DataAnnotations 有什么区别
IValidatableObject 是 C# 中一个接口，用于在模型绑定或序列化后执行跨属性、业务逻辑相关的验证。它不替代 [Required]、[Range] 这类单字段验证，而是补足它们无法覆盖的场景：比如“开始时间不能晚于结束时间”“当状态为已发货时，物流单号必填”这类依赖多个字段甚至外部状态的判断。
-
IValidatableObject.Validate方法只在对象整体被校验时调用（如 MVC 的ModelState.IsValid、Validator.TryValidateObject） - 它返回
ValidationResult集合，每个结果可关联一个或多个属性名（用MemberNames指定），也可不关联（全局错误） - 和
DataAnnotations不同，它不支持自动触发客户端验证（除非手动集成），也不参与属性级元数据发现
如何正确实现 Validate 方法并返回多字段错误
关键不是“写个 if 判断”，而是让错误能准确定位到对应字段，方便前端展示：
- 使用
ValidationResult.Success表示通过（不要 return null 或空集合） - 对跨字段错误，推荐显式指定
MemberNames，例如开始/结束时间冲突时，同时标记两个字段：if (StartDate > EndDate) { yield return new ValidationResult( "开始时间不能晚于结束时间", new[] { nameof(StartDate), nameof(EndDate) }); } - 若是全局业务规则（如“用户余额不足无法提交订单”），可传空数组或 null：
new ValidationResult("余额不足") - 注意：不要在
Validate中抛异常，这会导致校验流程中断，ModelState也不会收集错误
常见陷阱：异步验证、循环引用、性能开销
IValidatableObject.Validate 是同步方法，无法直接 await：
- 如果需要查数据库（如“用户名是否已存在”），必须提前在 Action 或 Service 层完成，并将结果传入模型（例如加一个
IsUsernameAvailablebool 属性），再在Validate中检查 - 避免在
Validate中调用可能引发递归的对象访问（如访问导航属性触发 EF 延迟加载），容易导致栈溢出或 N+1 查询 - 复杂计算（如 JSON 解析、正则全量匹配）应加缓存或短路判断，因为每次
ModelState.IsValid都会完整执行该方法
和 FluentValidation 对比：什么时候该换工具
IValidatableObject 简单轻量，适合小规模、低耦合的跨字段规则；但一旦出现以下情况，就该考虑 FluentValidation：
- 验证逻辑需要复用（如多个 DTO 共享“金额必须大于零且为两位小数”）
- 需要分组验证（如“创建时校验 A+B，编辑时校验 A+C”）
- 要求异步支持、条件分支嵌套深、或需注入服务（如
IUserService） - 错误消息需本地化，且希望与属性名解耦（FluentValidation 支持
WithMessage(x => x.Localize(...))）
原生 IValidatableObject 没有内置服务定位能力，所有依赖都得靠构造函数注入或静态上下文，容易让模型变重。
跨属性验证真正难的不是写对错判断，而是决定错误归属哪个字段、要不要阻断后续流程、以及怎么把外部依赖干净地接进来——这些细节没处理好，ModelState 就会漏报或误报。
