如何在ASP.NET Core 8中移除IdentityUser的UserName字段

要移除或禁用ASP.NET Identity中IdentityUser的UserName字段，核心思路是自定义用户实体类、调整EF Core映射配置，并重构身份验证逻辑以替代UserName的作用，以下是具体实现步骤：

1. 自定义用户实体类 #

创建继承自IdentityUser的自定义用户类，无需额外声明UserName，后续通过配置让该字段失效：

public class AppUser : IdentityUser
{
    // 可添加自定义属性，无需处理UserName
}

2. 配置EF Core映射，调整UserName字段行为 #

在你的DbContext的OnModelCreating方法中，修改UserName的约束，或直接忽略该字段（忽略需谨慎，部分Identity内部逻辑可能依赖）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 方案1：将UserName设为非必填，取消唯一索引
    modelBuilder.Entity<AppUser>()
        .Property(u => u.UserName)
        .IsRequired(false);

    modelBuilder.Entity<AppUser>()
        .HasIndex(u => u.UserName)
        .IsUnique(false);

    // 方案2：完全忽略UserName字段（仅当确认Identity核心逻辑不依赖时使用）
    // modelBuilder.Entity<AppUser>().Ignore(u => u.UserName);

    // 将Email设为唯一标识，替代UserName的作用
    modelBuilder.Entity<AppUser>()
        .HasIndex(u => u.Email)
        .IsUnique();
}

3. 配置Identity选项，禁用UserName强制约束 #

在Program.cs（或Startup.cs）中，调整Identity配置，强制使用Email作为用户唯一标识，并限制UserName的使用：

builder.Services.AddDefaultIdentity<AppUser>(options => 
{
    options.SignIn.RequireConfirmedAccount = true;
    options.User.RequireUniqueEmail = true;
    options.User.AllowedUserNameCharacters = string.Empty; // 禁止输入任何UserName字符
})
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddDefaultTokenProviders();

4. 重构身份验证逻辑，改用Email登录 #

默认Identity登录逻辑依赖UserName，需修改登录逻辑，通过Email查找用户并验证：

[HttpPost]
public async Task<IActionResult> Login(LoginViewModel model)
{
    if (ModelState.IsValid)
    {
        // 通过Email查找用户，替代FindByNameAsync
        var user = await _userManager.FindByEmailAsync(model.Email);
        if (user != null && await _userManager.CheckPasswordAsync(user, model.Password))
        {
            await _signInManager.SignInAsync(user, model.RememberMe);
            return RedirectToAction("Index", "Home");
        }
        ModelState.AddModelError(string.Empty, "无效的登录尝试");
    }
    return View(model);
}

5. 更新数据库迁移 #

执行以下命令生成并应用新的迁移，确保数据库中UserName字段的约束被修改：

Add-Migration RemoveUserNameConstraints
Update-Database

注意事项 #

• 若部分Identity内置功能（如UserManager.FindByNameAsync）仍被调用，需替换为FindByEmailAsync或自定义查找逻辑；
• 完全忽略UserName字段可能导致部分Identity扩展功能异常，建议优先采用“设为非必填+取消唯一索引”的方案；
• 确保所有用户创建逻辑中不再强制设置UserName，可将其设为null或与Email保持一致（避免空值问题）。

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