ASP.NET Core Blazor 中表单参数绑定的空值处理问题

在 ASP.NET Core Blazor 的静态服务器端渲染(Static SSR)模式下，开发人员在使用表单参数绑定时可能会遇到一个特殊问题：当表单中包含未勾选的复选框(InputCheckbox)时，使用 [SupplyParameterFromForm] 属性标记的模型参数会被错误地设置为 null，而不是保留初始值或设置为 false。

问题现象

当开发者在 Blazor 组件中定义如下代码时会出现问题：

<EditForm Model="_model" FormName="my-form">
    <InputCheckbox @bind-Value="_model.RememberMe" />
    <button type="submit">提交</button>
</EditForm>

@code {
    [SupplyParameterFromForm] 
    private InputModel _model { get; set; } = new();

    private record InputModel
    {
        public bool RememberMe { get; set; }
    }
}

当用户提交未勾选的复选框时，_model 参数会被设置为 null，导致后续操作抛出 InvalidOperationException 异常，提示需要提供 Model 或 EditContext 参数。

技术背景

这个问题源于 Blazor 的表单数据处理机制：

1. 在静态 SSR 模式下，表单提交会触发服务器端处理
2. 未勾选的复选框在 HTML 表单提交时不会包含任何值
3. Blazor 的参数绑定系统需要正确处理这种"空值"情况

问题根源

问题的核心在于：

1. 当复选框未勾选时，表单数据中不会包含该字段
2. Blazor 9.0.2 版本中，空字符串无法正确解析为布尔值 false
3. 这导致整个模型参数被设置为 null，而不是保留原有实例

解决方案

这个问题已经在 ASP.NET Core 10.0 版本中得到修复。在 10.0 版本中：

1. 空表单值能够正确解析为布尔值 false
2. 模型实例不会被错误地置为 null
3. 参数绑定系统能够正确处理未勾选复选框的情况

临时解决方案

对于仍在使用 9.0.2 版本的开发者，可以采用以下临时解决方案：

1. 在 OnInitialized 方法中初始化模型
2. 为布尔属性设置默认值
3. 添加额外的空值检查逻辑

@code {
    [SupplyParameterFromForm] 
    private InputModel _model { get; set; }

    protected override void OnInitialized() => _model ??= new InputModel();

    private record InputModel
    {
        public bool RememberMe { get; set; } = false;
    }
}

最佳实践

为了避免类似问题，建议开发者：

1. 始终为布尔类型属性设置默认值
2. 在模型类中考虑所有可能的空值情况
3. 及时升级到最新稳定版本以获取修复
4. 在关键表单操作前添加空值检查

这个问题提醒我们在处理表单数据时需要特别注意 HTML 表单提交行为的特殊性，特别是对于布尔值和可选字段的处理。