自定义Identity Core的ASP.NET Core Web应用登录失败排查

密码哈希算法不匹配 #

• 核心问题大概率是注册端和当前登录端的密码哈希算法不一致。因为用户注册在其他应用，要确认那边生成密码哈希时用的算法、版本和当前Identity的配置完全对齐。
• 检查当前项目的密码哈希配置，默认用PasswordHasher<Customer>，如果注册端是旧版Identity（比如V2），要手动指定兼容模式：

  builder.Services.Configure<PasswordHasherOptions>(options =>
  {
      options.CompatibilityMode = PasswordHasherCompatibilityMode.IdentityV2;
  });
  

• 如果注册端是自定义哈希逻辑，必须在当前项目实现一模一样的IPasswordHasher<Customer>，替换默认服务：

  builder.Services.AddScoped<IPasswordHasher<Customer>, YourCustomPasswordHasher>();
  

数据库映射错误 #

• 绝对不能在OnModelCreating里忽略PasswordHash字段！如果数据库里没存这个字段，或者映射失败，CheckPasswordAsync根本拿不到哈希值验证，必败。
• 检查Customer类继承IdentityUser后，有没有重写PasswordHash属性导致映射异常，正常情况不要碰这个属性：

  public class Customer : IdentityUser
  {
      // 只加自定义字段，别动PasswordHash这些核心属性
      public string CustomerCode { get; set; }
  }
  

• 去数据库里直接看PasswordHash字段，确认有值且格式符合Identity规则（一般是$V3$...或$V2$...开头的字符串）。

UserManager/SignInManager配置遗漏 #

• 确认AddIdentityCore的配置完整，关联了自定义的Customer和数据库上下文，还要显式注册UserManager和SignInManager：

  builder.Services.AddIdentityCore<Customer>(options =>
  {
      // 密码规则要和注册端一致，比如是否要求数字、长度等
      options.Password.RequireUppercase = false;
  })
  .AddEntityFrameworkStores<CustomersInformationDBContext>()
  .AddUserManager<UserManager<Customer>>()
  .AddSignInManager<SignInManager<Customer>>();
  

• 少了上面任何一步，注入的管理类可能无法正常读取用户数据或执行验证。

登录逻辑细节问题 #

• 检查登录时的用户名是否和数据库里的完全一致，比如大小写（如果数据库用了大小写敏感的排序规则，大小写不一样会查不到用户）。
• 调用CheckPasswordAsync前，先确认已经正确获取到Customer实例：

  var customer = await _userManager.FindByNameAsync(input.Username);
  if (customer == null)
  {
      // 用户不存在，直接返回失败提示
      return BadRequest("账号或密码错误");
  }
  var verifyResult = await _userManager.CheckPasswordAsync(customer, input.Password);
  

• 还要看用户的LockoutEnabled是否为true，以及LockoutEnd有没有过期，如果账号被锁，PasswordSignInAsync也会返回Failed。

数据库上下文配置错误 #

• 确保CustomersInformationDBContext正确继承IdentityDbContext<Customer>，而且OnModelCreating要先调用base.OnModelCreating(modelBuilder)，再忽略不需要的字段：

  public class CustomersInformationDBContext : IdentityDbContext<Customer>
  {
      public CustomersInformationDBContext(DbContextOptions<CustomersInformationDBContext> options) : base(options) { }
  
      protected override void OnModelCreating(ModelBuilder modelBuilder)
      {
          base.OnModelCreating(modelBuilder); // 先执行Identity的默认映射
          // 再忽略不需要的字段，比如EmailConfirmed、PhoneNumberConfirmed这些
          modelBuilder.Entity<Customer>().Ignore(c => c.EmailConfirmed);
          modelBuilder.Entity<Customer>().Ignore(c => c.PhoneNumberConfirmed);
      }
  }
  

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