ASP.NET Blazor Server表单验证后处理Identity错误的问题

问题场景 #

在ASP.NET Blazor Server应用中自定义员工注册表单，已完成常规验证（含自定义日期验证属性），但邮箱/用户名唯一性验证存在问题：ASP.NET Identity框架在表单验证通过后，返回包含错误描述（如“用户名'XXX'已被占用”）的IdentityResult，但无法将该错误转为页面上的验证消息，导致操作失败时无提示。

相关页面代码 #

@page "/Employee/Create"

@using Microsoft.AspNetCore.Components.Authorization
@using Microsoft.AspNetCore.Identity
@inject AuthenticationStateProvider AuthenticationStateProvider
@inject UserManager<ApplicationUser> userManager
@inject NavigationManager NavigationManager
@inject IDataAccess database

<AuthorizeView Roles="Admin" Context="authContext">
    <Authorized>
        <h3>New Employee</h3>
        <EditForm Model="_employee" Context="formContext" OnValidSubmit="@HandleValidSubmit">
            <DataAnnotationsValidator />
            <ValidationSummary />
            <p>First Name: <InputText id="firstName" class="rounded-border" @bind-Value="_employee.FirstName" /></p>
            <p>Last Name: <InputText id="lastName" class="rounded-border" @bind-Value="_employee.LastName" /></p>
            <p>Email: <InputText id="email" class="rounded-border" @bind-Value="_employee.Email" /></p>

            <div id="newEmployeeButtons">
                <button type="submit" class="btn btn-primary">Save</button>
            </div>
        </EditForm>
    </Authorized>
</AuthorizeView>

@code {
    private Employee _employee = new();

    protected override void OnInitialized()
    {
        _employee = new Employee();
    }

    private async Task HandleValidSubmit()
    {
        ApplicationUser user = new()
        {
            FirstName = _employee.FirstName,
            LastName = _employee.LastName,
            Email = _employee.Email
        };

        var result = await userManager.CreateAsync(user, _tempPassword);
        if (result.Succeeded)
        {
            // Save to main DB
            _employee.Id = await userManager.GetUserIdAsync(user);
            await database.CreateEmployeeAsync(_employee);
            _employee = new(); // Clear form
        }
        else
        {
            // Microsoft.AspNetCore.Identity.IdentityResult returns an error here,
            // NOT an exception. The error has a description of "Username 'XXX'
            // is already taken."
            // HOW DO I TURN THIS INTO A VALIDATION MESSAGE ON THE PAGE?!
            // Currently it just fails silently
        }
    }
}

解决方案 #

要将Identity返回的错误显示到页面验证消息中，需手动操作EditContext的验证消息集合，步骤如下：

1. 正确初始化并绑定EditContext #

在@code块中声明私有EditContext变量，在OnInitialized中正确初始化，并将EditForm的EditContext属性绑定到该变量（替代原Model属性绑定）：

页面EditForm修改：

<EditForm EditContext="_editContext" Context="formContext" OnValidSubmit="@HandleValidSubmit">
    <DataAnnotationsValidator />
    <ValidationSummary />
    <!-- 表单字段保持不变 -->
</EditForm>

@code块修改：

@code {
    private Employee _employee = new();
    private EditContext _editContext;

    protected override void OnInitialized()
    {
        _employee = new Employee();
        _editContext = new EditContext(_employee); // 正确初始化方式，不能在方法内重新声明变量
    }
}

2. 在提交方法中处理Identity错误 #

当IdentityResult失败时，遍历错误集合，将错误添加到对应字段的验证消息中，并通知组件验证状态变更：

private async Task HandleValidSubmit()
{
    ApplicationUser user = new()
    {
        FirstName = _employee.FirstName,
        LastName = _employee.LastName,
        Email = _employee.Email
    };

    var result = await userManager.CreateAsync(user, _tempPassword);
    if (result.Succeeded)
    {
        // 保存到主数据库
        _employee.Id = await userManager.GetUserIdAsync(user);
        await database.CreateEmployeeAsync(_employee);
        // 重置表单和验证状态
        _employee = new();
        _editContext = new EditContext(_employee);
    }
    else
    {
        // 清除之前的验证错误
        _editContext.ClearValidationMessages();

        // 将Identity错误添加到对应字段
        foreach (var error in result.Errors)
        {
            // 根据错误关联字段，这里以Email为例
            var field = new FieldIdentifier(_employee, nameof(_employee.Email));
            _editContext.AddValidationMessage(field, error.Description);
        }

        // 通知组件验证状态已更新
        _editContext.NotifyValidationStateChanged();
    }
}

调试中发现的关键问题 #

• master分支中EditContext_OnFieldChanged方法未触发：因EditContext初始化方式错误，导致页面绑定的上下文失效
• 移除EditForm的Model属性后引发异常：EditForm必须绑定Model或EditContext其中一个，不能同时为空
• EditContext初始化注意事项：必须使用类成员赋值_editContext = new(_employee);，不能在方法内重新声明EditContext _editContext = new(_employee);，后者会创建局部变量，导致页面绑定的上下文未被正确初始化

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