CommunityToolkit.Mvvm 中 ObservableValidator 的验证事件机制解析

问题背景

在 CommunityToolkit.Mvvm 8.2.2 版本中，开发者发现 ObservableValidator 类的 SetProperty 方法在验证状态从"有错误"变为"无错误"时，不会触发 PropertyChanged 和 ErrorsChanged 事件。这与 TrySetProperty 方法的行为不一致，后者在这种情况下会正确触发相关事件。

核心问题分析

ObservableValidator 是一个实现了 INotifyDataErrorInfo 接口的基类，用于在 MVVM 模式中提供属性验证功能。当属性值发生变化时，它应该：

1. 验证新值
2. 如果验证状态发生变化，触发 ErrorsChanged 事件
3. 如果 HasErrors 属性发生变化，触发 PropertyChanged 事件

然而，在以下场景中出现了不一致行为：

1. 属性初始值为 null（验证失败）
2. 将属性设置为有效值（如非空字符串）
3. 此时验证通过，但不会触发任何通知事件

技术原理

ObservableValidator 内部维护了一个错误字典来跟踪每个属性的验证状态。当调用 SetProperty 方法时：

1. 首先比较新旧值，如果相同则直接返回
2. 如果不同，则更新字段值并触发 PropertyChanged 事件
3. 如果 validate 参数为 true，则执行验证
4. 验证结果发生变化时，更新错误字典

问题出在第4步：当错误被清除时（从有错误变为无错误），虽然错误字典被更新，但没有触发相应的事件通知。

解决方案比较

官方方案

根据项目维护者的解释，这是设计上的预期行为。因为初始状态下（对象刚创建时），虽然属性值为 null，但尚未主动执行验证，因此错误字典中并没有记录错误。要解决这个问题，可以在对象构造后立即调用 ValidateAllProperties() 方法强制验证所有属性。

开发者方案

开发者提出了一个扩展方案，通过继承 ObservableValidator 并重写 SetProperty 方法，在错误状态从有到无时手动触发事件通知：

protected bool Set<T>(ref T field, T newValue, bool validate = true, string propertyName = null)
{
    var hadError = GetErrors(propertyName).Any();
    var changed = SetProperty(ref field, newValue, validate, propertyName);

    if (hadError && !GetErrors(propertyName).Any()) 
        OnPropertyChanged(nameof(HasErrors));

    return changed;
}

最佳实践建议

1. 对于需要严格验证的场景，建议在 ViewModel 构造函数中调用 ValidateAllProperties() 方法初始化验证状态
2. 如果需要确保错误状态变化时总是触发通知，可以考虑使用 TrySetProperty 方法替代 SetProperty
3. 如果采用扩展方案，要注意确保所有属性设置都使用新的 Set 方法，保持一致性

总结

CommunityToolkit.Mvvm 中的 ObservableValidator 在设计上区分了"被动验证"和"主动验证"两种模式。理解这一设计理念对于正确使用验证功能至关重要。开发者可以根据具体需求选择官方推荐的方式或自定义扩展方案来满足业务需求。