.NET 5 Blazor WebAssembly 自定义文件输入组件验证状态不更新异常

算力阿峰

2026-10-28

问题根因定位

核心不兼容点：可变集合的处理逻辑和内置输入组件的设计不匹配
参考教程开发的自定义组件，原本是适配string这类不可变值类型设计的，而Blazor所有内置输入组件的基类InputBase<T>，判断字段是否变更的逻辑默认用EqualityComparer<T>.Default做相等性比对：对引用类型而言，这个比对只检查两个对象的内存地址是否一致，不会遍历集合内部的元素变化。
你现在的实现是把新上传的文件直接Add到原有List实例上，从头到尾没有为集合生成新的内存实例。哪怕集合内部元素从1个变成2个，新旧两个List的内存地址完全相同，组件的变更追踪逻辑会直接判定“值根本没变化”。
为什么第一次上传1个文件时状态显示正常？因为页面初始加载时Files字段的初始值是空/null，第一次上传文件时你是新建了一个List实例，和初始值的引用不同，所以能正常触发modified标记，跑校验显示invalid状态。第二次上传文件时，你是在已经存在的List上追加元素，集合引用没有变化，追踪逻辑直接卡滞，不会主动刷新状态。
手动通知字段变更的时机错位
你现在的代码逻辑是：修改现有集合 → 触发模型回调同步值 → 手动调用EditContext.NotifyFieldChanged。这个流程完全跳过了InputBase内部用来比对值差异、同步状态标记的核心逻辑。
而且.NET 5版本的EditContext收到字段变更通知时，只会标记字段为已修改，不会自动清除之前缓存的校验错误——如果没有走完完整的组件值比对流程，之前的invalid状态会一直留在组件的状态缓存里，不会自动切换为valid。
Range校验的触发逻辑限制
你用的RangeAttribute校验器，本身只会在字段的整体引用变化时才重新执行校验。你修改集合内部元素、但集合引用没变的情况下，就算手动触发通知，校验器重新拿到的还是原来的集合引用，虽然能读到当前的元素数量，但因为组件内部的状态机没有走完刷新流程，之前缓存的错误也不会被移除。

修复操作步骤

调整集合更新逻辑，永远给字段赋新的List实例，绝对不要直接修改原集合的引用
把原来直接给现有List追加元素的代码，替换成基于原集合生成新实例的写法，示例代码：

// 错误写法：直接修改原集合，引用地址不变
// CurrentValue.Add(ConvertBrowserFileToDocumentModel(browserFile));

// 正确写法：生成新的List实例，通过组件内置的CurrentValue属性完成赋值
var originalList = CurrentValue ?? new List<DocumentModel>();
var updatedList = new List<DocumentModel>(originalList)
{
    ConvertBrowserFileToDocumentModel(browserFile)
};
CurrentValue = updatedList;

这种写法会让组件的变更追踪逻辑检测到新旧值的引用差异，自然识别到值已变更，正常触发后续的状态刷新流程。

删掉手动编写的EditContext.NotifyFieldChanged调用代码
InputBase<T>内置的CurrentValue赋值逻辑，本来就会在值变更完成后自动触发字段变更通知，手动调用反而会因为执行时机不对，打断内部的状态计算流程。
完成上述两步后，无需额外修改其他逻辑，组件状态就会恢复正常：
每次上传文件生成新的List实例赋值时，组件会自动完成标记modified、通知EditContext变更、触发DataAnnotationsValidator重新校验的全流程。当集合文件数达到Range要求的2个时，校验器会自动移除之前的错误提示，组件CSS类也会自动从modified invalid切换为modified valid。

如果改完上述步骤后依然存在状态卡滞，可重写组件内置的相等比对逻辑，让它识别集合内部的元素数量变化，不再只依赖内存地址做判断：

// 重写InputBase基类的相等比对方法
protected override bool Equals(List<DocumentModel>? oldValue, List<DocumentModel>? newValue)
{
    // 只要两个集合的元素数量一致，就判定为相等；数量发生变化即视为值变更
    return (oldValue?.Count ?? 0) == (newValue?.Count ?? 0);
}

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