ASP.NET Core MVC多表单验证汇总串扰问题求助（Umbraco 10）

问题根源 #

默认的@Html.ValidationSummary()会渲染所有ModelState中的错误，不区分错误所属表单。当页面存在多个表单时，提交单个表单产生的错误会被所有表单的验证汇总区域显示，导致串显示问题。

解决方案：用模型前缀区分表单错误 #

通过给每个表单的模型添加独立前缀，让错误与对应表单绑定，再让验证汇总只渲染对应前缀的错误，即可解决该问题。

1. 控制器端：给模型绑定前缀 #

在处理表单提交的Action参数上，添加[Bind(Prefix = "表单标识")]属性，指定模型的专属前缀。以登录表单为例：

[HttpPost]
[ValidateUmbracoFormRouteString]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Login([Bind(Prefix = "Login")] LoginForm model)
{
    if (!ModelState.IsValid)
    {
        // 添加带前缀的全局错误
        ModelState.AddModelError("Login.", "请提供用户名和密码");
        return CurrentUmbracoPage();
    }
    // 登录逻辑（省略）
}

注册表单同理，给参数添加[Bind(Prefix = "Register")]，添加错误时使用ModelState.AddModelError("Register.", "注册错误提示")。

2. 视图端：渲染带前缀的表单与验证 #

渲染表单时，给所有字段指定带前缀的name属性，并让验证汇总只显示对应前缀的错误：

登录表单视图代码

@model LoginForm
@using (Html.BeginForm("Login", "AuthSurface", FormMethod.Post))
{
    @Html.AntiForgeryToken()
    
    <!-- 仅显示Login前缀的错误 -->
    @Html.ValidationSummary(false, "", new { @class = "text-danger" }, "Login")
    
    <!-- 给字段指定带前缀的name属性 -->
    @Html.TextBoxFor(m => m.Username, new { @class = "form-control", name = "Login.Username" })
    @Html.ValidationMessageFor(m => m.Username, "", new {}, "Login")
    
    @Html.PasswordFor(m => m.Password, new { @class = "form-control", name = "Login.Password" })
    @Html.ValidationMessageFor(m => m.Password, "", new {}, "Login")
    
    <button type="submit" class="btn btn-primary">登录</button>
}

注册表单视图代码

@model RegisterForm
@using (Html.BeginForm("Register", "AuthSurface", FormMethod.Post))
{
    @Html.AntiForgeryToken()
    
    <!-- 仅显示Register前缀的错误 -->
    @Html.ValidationSummary(false, "", new { @class = "text-danger" }, "Register")
    
    @Html.TextBoxFor(m => m.Email, new { @class = "form-control", name = "Register.Email" })
    @Html.ValidationMessageFor(m => m.Email, "", new {}, "Register")
    
    <!-- 其他注册字段（省略） -->
    
    <button type="submit" class="btn btn-secondary">注册</button>
}

原理说明 #

• 前缀会让ModelState中的错误键带上表单标识.的前缀（如Login.Username、Login.），不同表单的错误不会混淆。
• @Html.ValidationSummary的最后一个参数为前缀，指定后只会渲染对应前缀的错误。
• 表单字段的name属性指定前缀后，提交时模型绑定能正确识别对应数据。

简化方案：直接在视图过滤错误 #

如果不想修改字段名称，也可以在视图中自定义筛选逻辑，只显示当前表单的错误。以登录表单为例：

@{
    var loginErrors = ViewData.ModelState
        .Where(kv => kv.Key.StartsWith("Login.") || kv.Key == "Login.")
        .SelectMany(kv => kv.Value.Errors)
        .Select(e => e.ErrorMessage);
}
@if (loginErrors.Any())
{
    <div class="text-danger">
        <ul>
            @foreach (var error in loginErrors)
            {
                <li>@error</li>
            }
        </ul>
    </div>
}

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