.NET 8 Blazor Identity扩展用户属性保存失败问题排查

核心问题 #

本质是表单数据未正确绑定到自定义扩展属性：默认Identity UI的Manage页面只处理内置属性（如手机号），扩展属性需要手动配置绑定逻辑，否则提交时无法获取表单值；初始化时的赋值是为了同步数据库原有数据到表单，注释后自然无法显示原有数据，但此时若绑定逻辑正确，提交时能保存新输入的值。

解决步骤 #

1. 扩展页面的InputModel类 #

打开Components/Account/Pages/Manage/Index.razor，找到代码段中的InputModel，添加你的扩展属性：

private class InputModel
{
    // 保留原有内置属性
    [Phone]
    [Display(Name = "Phone number")]
    public string? PhoneNumber { get; set; }

    // 新增自定义扩展属性
    [Display(Name = "个人简介")]
    public string? Introduction { get; set; }

    [Display(Name = "个人网站")]
    public string? Website { get; set; }
}

2. 修正表单控件的绑定 #

在页面表单区域，将扩展属性对应的Input控件绑定到Input.XXX，示例：

<div class="form-floating mb-3">
    <InputText @bind-Value="Input.Introduction" class="form-control" />
    <label>@Display.NameFor(m => m.Introduction)</label>
</div>

<div class="form-floating mb-3">
    <InputText @bind-Value="Input.Website" class="form-control" />
    <label>@Display.NameFor(m => m.Website)</label>
</div>

3. 同步初始化数据到表单 #

在OnInitializedAsync()方法中，将自定义User的扩展属性赋值给InputModel：

protected override async Task OnInitializedAsync()
{
    var user = await UserManager.GetUserAsync(User);
    if (user == null)
    {
        throw new InvalidOperationException($"无法加载ID为'{UserManager.GetUserId(User)}'的用户。");
    }

    // 同步内置属性
    Input.PhoneNumber = user.PhoneNumber;
    // 强转为自定义User类，同步扩展属性
    var customUser = (User)user;
    Input.Introduction = customUser.Introduction;
    Input.Website = customUser.Website;

    await LoadAsync(user);
}

4. 提交时保存扩展属性 #

修改OnValidSubmitAsync()方法，将InputModel中的扩展属性值赋值回自定义User并保存：

protected async Task OnValidSubmitAsync()
{
    var user = await UserManager.GetUserAsync(User);
    if (user == null)
    {
        throw new InvalidOperationException($"无法加载ID为'{UserManager.GetUserId(User)}'的用户。");
    }

    // 保留原有内置属性的保存逻辑
    if (Input.PhoneNumber != user.PhoneNumber)
    {
        var setPhoneResult = await UserManager.SetPhoneNumberAsync(user, Input.PhoneNumber);
        if (!setPhoneResult.Succeeded)
        {
            var userId = await UserManager.GetUserIdAsync(user);
            throw new InvalidOperationException($"设置手机号时出现意外错误，用户ID：'{userId}'。");
        }
    }

    // 保存自定义扩展属性
    var customUser = (User)user;
    customUser.Introduction = Input.Introduction;
    customUser.Website = Input.Website;
    await UserManager.UpdateAsync(customUser);

    await SignInManager.RefreshSignInAsync(user);
    StatusMessage = "你的个人信息已更新。";
}

问题根源说明 #

• 直接绑定user对象时，Blazor的组件数据追踪机制对继承自IdentityUser的自定义类支持不佳，导致提交时无法捕获属性变化；用InputModel作为中间层是Identity UI的标准设计，能确保数据绑定稳定。
• 初始化时给Input赋值是为了将数据库中的原有数据同步到表单控件，注释后表单控件初始值为空，所以无法显示原有数据；若直接绑定user扩展属性，提交时虽能保存，但这种绑定方式存在稳定性隐患，建议统一使用InputModel的标准流程。

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