ASP.NET MVC Identity初始化管理员用户登录失败问题排查

核心问题及解决方法： #

• SecurityStamp设置无效
  Identity的SecurityStamp用于校验用户身份有效性，你将其设为空字符串string.Empty，会导致SignInManager登录验证失败。需生成随机GUID作为该字段值。

• PasswordHasher.HashPassword参数错误
  调用passwordHasher.HashPassword(null, "Admin123!")时传入null作为用户实例，默认密码哈希器会结合用户的SecurityStamp等属性生成哈希值，传入null生成的哈希与登录时用完整用户对象验证的哈希不匹配。必须传入创建好的ApplicationUser实例。

• 数据库种子数据未同步更新
  若修改种子数据后未重新生成迁移并更新数据库，数据库中存储的PasswordHash或SecurityStamp还是旧值，会导致验证失败。需执行以下命令同步：

  Add-Migration UpdateSeedData
  Update-Database
  

修改后的用户种子数据代码 #

public void Configure(EntityTypeBuilder<ApplicationUser> builder)
{
    var adminUser = new ApplicationUser
    {
        Id = "361e2fcb-21b1-426d-a860-c278a463356d",
        UserName = "Admin",
        NormalizedUserName = "ADMIN",
        Email = "admin@gmail.com",
        NormalizedEmail = "ADMIN@GMAIL.COM",
        EmailConfirmed = true,
        SecurityStamp = Guid.NewGuid().ToString(), // 生成随机SecurityStamp
        Name = "Admin",
        Surename = "Main",
    };

    var passwordHasher = new PasswordHasher<ApplicationUser>();
    adminUser.PasswordHash = passwordHasher.HashPassword(adminUser, "Admin123!"); // 传入用户实例生成哈希

    builder.HasData(adminUser);
}

额外配置（可选） #

若使用邮箱作为登录凭证，需确保Identity允许通过邮箱登录，在Program.cs/Startup.cs中添加配置：

builder.Services.Configure<IdentityOptions>(options =>
{
    options.User.AllowedUserNameCharacters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._@+";
    options.User.RequireUniqueEmail = true;
});

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