FluentValidation中When条件修饰符的正确使用方式

FluentValidation作为.NET生态中流行的验证库，其条件验证功能非常强大但也容易产生误解。本文将深入解析When修饰符的工作原理，帮助开发者避免常见的陷阱。

条件验证的基本行为

在FluentValidation中，When方法用于为验证规则添加条件判断。但有一个关键行为需要特别注意：默认情况下，When条件会应用于链式调用中所有前面的验证器。

RuleFor(x => x.SomeId)
   .NotEmpty().When(x => x.Type == ProjectType.MovieFocused)
   .Null().When(x => x.Type != ProjectType.MovieFocused);

在这个例子中，第二个When不仅会影响Null()验证器，还会影响前面的NotEmpty()验证器。这通常不是开发者期望的行为。

问题重现

假设我们有以下验证场景：

public enum ProjectType {
    MovieFocused,
    Other
}

public class ProjectRequest {
    public Guid? SomeId { get; set; }
    public ProjectType Type { get; set; }
}

当使用上述验证规则时，会发现：

1. 对于Type = MovieFocused且SomeId = null的情况，预期应该验证失败但实际通过
2. 只有最后一个When条件真正生效

解决方案

FluentValidation提供了ApplyConditionTo枚举来控制条件应用的范围：

RuleFor(x => x.SomeId)
    .NotEmpty().When(x => x.Type == ProjectType.MovieFocused, ApplyConditionTo.CurrentValidator)
    .Null().When(x => x.Type != ProjectType.MovieFocused, ApplyConditionTo.CurrentValidator);

通过指定ApplyConditionTo.CurrentValidator，我们确保每个When条件只应用于它直接修饰的验证器。

替代方案

如果觉得上述语法不够直观，也可以选择拆分为多个规则：

RuleFor(x => x.SomeId)
    .NotEmpty().When(x => x.Type == ProjectType.MovieFocused);

RuleFor(x => x.SomeId)
    .Null().When(x => x.Type != ProjectType.MovieFocused);

这种方式逻辑更加清晰，但会产生稍多的代码。

最佳实践

1. 明确条件范围：始终考虑When条件会影响哪些验证器
2. 优先使用CurrentValidator：除非确实需要条件影响多个验证器
3. 复杂逻辑拆分：当条件逻辑复杂时，拆分为多个规则可提高可读性
4. 测试覆盖：为条件验证编写全面的测试用例

理解FluentValidation的这一设计特性，可以帮助开发者编写出更加精确和可靠的验证逻辑。