FluentValidation 如何实现类互斥可选属性的校验逻辑

传统嵌套When的写法在互斥属性数量增加时，会出现规则分支膨胀、逻辑易漏判、代码可读性差的问题，完全可以通过基于整体状态统计的思路替代冗余的分支判断，核心实现逻辑如下：

核心实现步骤 #

1. 统一属性“是否被赋值”的判定标准 #

针对示例中的IEnumerable<int>类型可选属性，需要兼容两种“未赋值”场景：属性为null、属性为空序列（空序列在业务上和未赋值无差异），可定义统一的判断逻辑，避免规则中散落重复判断：

public static class EnumerableExtensions
{
    /// <summary>
    /// 判断序列是否实际存在有效值
    /// </summary>
    public static bool HasAnyValue<T>(this IEnumerable<T> source)
    {
        // 可根据业务调整：如果要求“只要不是null就算赋值”，直接返回 source != null 即可
        return source != null && source.Any();
    }
}

2. 无分支的互斥规则实现 #

不需要枚举所有互斥组合，只需要统计所有可选属性中“实际被赋值”的数量，只要满足被赋值的属性数量 ≤1就符合互斥要求。
完整的校验器实现示例：

public class SomeClassValidator : AbstractValidator<SomeClass>
{
    public SomeClassValidator()
    {
        // 原有必填属性校验逻辑保持不变
        RuleFor(x => x.SomeDate)
            .NotEmpty()
            .WithMessage("SomeDate 为必填项");

        // 核心互斥校验，无嵌套When分支
        RuleFor(x => new[]
        {
            x.FirstOptionalProperty.HasAnyValue(),
            x.SecondOptionalProperty.HasAnyValue(),
            x.ThirdOptionalProperty.HasAnyValue()
        })
        .Must(hasValueFlags => hasValueFlags.Count(flag => flag) <= 1)
        .WithMessage("三个可选属性最多只能设置一个，不支持同时赋值多个");
    }
}

方案优势 #

• 维护成本极低：后续新增互斥属性时，只需要在规则的数组中新增一行属性赋值状态的判断逻辑，不需要新增When分支、调整原有规则结构
• 逻辑无遗漏：不需要手动枚举所有两两互斥的场景，本质通过总数统计校验，从根上避免分支漏写、判断条件错位的问题
• 执行效率更高：单次遍历即可完成所有可选属性的状态判断，不需要在多个When分支中重复读取属性值

可选优化：精准错误提示 #

如果需要在校验失败时明确告知用户具体是哪几个属性产生了冲突，不需要拆分规则，仅需在Must逻辑中补充冲突属性名的收集即可：

// 替换上面的Must逻辑
.Must((model, hasValueFlags, context) =>
{
    var conflictedProperties = new List<string>();
    if (model.FirstOptionalProperty.HasAnyValue()) 
        conflictedProperties.Add(nameof(SomeClass.FirstOptionalProperty));
    if (model.SecondOptionalProperty.HasAnyValue()) 
        conflictedProperties.Add(nameof(SomeClass.SecondOptionalProperty));
    if (model.ThirdOptionalProperty.HasAnyValue()) 
        conflictedProperties.Add(nameof(SomeClass.ThirdOptionalProperty));

    if (conflictedProperties.Count > 1)
    {
        context.MessageFormatter.AppendArgument("ConflictProps", string.Join("、", conflictedProperties));
        return false;
    }
    return true;
})
.WithMessage("属性存在互斥冲突，最多只能设置一个：{ConflictProps}");

注意：如果你的业务规则是“最多设置1个（也就是允许全部不设置）”，上面的逻辑完全适配；如果业务规则是“有且只能设置1个，不允许全部不设置”，只需要把Must里的判断从<=1改成==1即可，不需要调整任何结构。

内容的提问来源于stack exchange，提问作者Anon Anon