.NET 5 Blazor Server下扩展整型主键EF Core Identity UserStore报错解决

编译错误原因 #

默认简写形式的UserStore<ApplicationUser>，实际等价于UserStore<TUser, IdentityRole, DbContext, string>，内置约定要求TUser必须是IdentityUser<string>的派生类，而你的ApplicationUser是IdentityUser<int>的派生类，两者主键泛型参数不兼容，因此无法完成隐式类型转换，触发编译错误。

运行时DbSet找不到的错误原因 #

仅传递4个泛型参数给UserStore时，剩余的实体类泛型参数会使用ASP.NET Identity内置的默认实现：即IdentityUserClaim<int>、IdentityUserRole<int>、IdentityUserLogin<int>等原生类型。但你的上下文完全使用了自定义的ApplicationUserRole等实体替代了原生类型，EF Core的模型中并未包含这些原生类型的配置，因此当UserStore内部尝试访问IdentityUserRole的DbSet时，会抛出类型未纳入模型的异常。

1. 统一自定义Identity实体定义 #

所有关联的Identity实体必须显式继承int主键版本的原生基类，避免使用默认的string主键实体：

• 用户实体：

public class ApplicationUser : IdentityUser<int>
{
    [Required]
    [MaxLength(50)]
    public string FirstName { get; set; }
    [Required]
    [MaxLength(50)]
    public string LastName { get; set; }
    // 显式声明密码历史的导航集合，避免空引用
    public ICollection<UsedPassword> UserUsedPassword { get; set; } = new List<UsedPassword>();
}

• 角色实体：

public class ApplicationRole : IdentityRole<int>
{
    // 可根据需要扩展自定义属性
}

• 用户角色关联实体：

public class ApplicationUserRole : IdentityUserRole<int>
{
    public bool IsSystemEssential { get; set; }

• 其余配套Identity实体（需全部定义，避免使用原生默认类型）：
  • ApplicationUserClaim : IdentityUserClaim<int>
  • ApplicationUserLogin : IdentityUserLogin<int>
  • ApplicationUserToken : IdentityUserToken<int>
  • ApplicationRoleClaim : IdentityRoleClaim<int>
• 自定义密码历史实体：

public class UsedPassword
{
    public int Id { get; set; }
    public int UserId { get; set; }
    public string HashPassword { get; set; }
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
}

2. ApplicationDbContext对齐泛型参数 #

不要使用默认的简化版IdentityDbContext<ApplicationUser>，需要将全量的自定义实体、int主键作为泛型参数传入，确保EF Core的模型和Identity内部逻辑使用完全一致的类型集合：

public class ApplicationDbContext : IdentityDbContext<
    ApplicationUser, 
    ApplicationRole, 
    int, 
    ApplicationUserClaim, 
    ApplicationUserRole, 
    ApplicationUserLogin, 
    ApplicationRoleClaim, 
    ApplicationUserToken>
{
    // 自定义实体的DbSet
    public DbSet<UsedPassword> UsedPasswords { get; set; }

    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options)
    {
    }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        // 配置密码历史和用户的一对多关系
        builder.Entity<UsedPassword>().HasOne<ApplicationUser>().WithMany(u => u.UserUsedPassword).HasForeignKey(p => p.UserId);
    }
}

注意：此处DbContext的泛型参数顺序必须和IdentityDbContext的定义完全匹配，不能颠倒顺序。

3. 自定义UserStore的正确继承写法 #

按照全量泛型参数列表继承基类，确保内部使用的所有实体类型和DbContext中的类型完全对齐：

public class ApplicationUserStore : UserStore<
    ApplicationUser, 
    ApplicationRole, 
    ApplicationDbContext, 
    int, 
    ApplicationUserClaim, 
    ApplicationUserRole, 
    ApplicationUserLogin, 
    ApplicationUserToken, 
    ApplicationRoleClaim>
{
    public ApplicationUserStore(ApplicationDbContext context, IdentityErrorDescriber describer = null) 
        : base(context, describer)
    {
    }

    // 重写创建用户逻辑，写入密码历史
    public override async Task<IdentityResult> CreateAsync(ApplicationUser user, CancellationToken cancellationToken = default)
    {
        var result = await base.CreateAsync(user, cancellationToken);
        if (result.Succeeded)
        {
            // 直接通过DbContext写入密码记录，避免通过导航属性触发多余的Update操作
            Context.UsedPasswords.Add(new UsedPassword
            {
                UserId = user.Id,
                HashPassword = user.PasswordHash,
                CreatedAt = DateTime.UtcNow
            });
            await SaveChanges(cancellationToken);
        }
        return result;
    }

    // 补充密码历史校验方法，供UserManager调用
    public async Task<bool> CheckPasswordHistoryAsync(ApplicationUser user, string passwordHash, CancellationToken cancellationToken = default)
    {
        return await Context.UsedPasswords.AnyAsync(p => p.UserId == user.Id && p.HashPassword == passwordHash, cancellationToken);
    }
}

4. 服务注册对齐全链路类型 #

在Startup/Program.cs中注册Identity服务时，确保所有泛型参数和自定义类型匹配，避免使用默认的string主键配置：

services.AddIdentity<ApplicationUser, ApplicationRole>(options =>
{
    // 配置对应的密码策略、锁定策略等
})
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddUserStore<ApplicationUserStore>()
.AddDefaultTokenProviders();

• 所有链路的泛型参数必须完全对齐：从实体定义、DbContext继承、UserStore/RoleStore继承到服务注册，涉及主键类型、自定义实体类型的位置，不能混合使用int主键和string主键、自定义实体和原生Identity实体。
• 声明DbSet时必须指定泛型参数类型，如public DbSet<ApplicationUserRole> ApplicationUserRoles { get; set; }，无泛型参数的DbSet无法被EF Core正确识别，会触发模型未包含该类型的异常。
• 避免在创建用户时通过导航属性添加密码历史记录后调用UpdateAsync，会触发无意义的全用户表字段更新，直接通过独立DbSet写入即可减少数据库操作开销。
• 如果需要自定义RoleStore，同样需要按照全量泛型参数的要求继承RoleStore<ApplicationRole, ApplicationDbContext, int, ApplicationUserRole, ApplicationRoleClaim>，否则会触发和UserStore相同的类型不匹配错误。

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