自定义继承IdentityUser<int>的User类后使用UserManager<User, int>报错的解决方法

这个错误的核心原因是UserManager<TUser, TKey>要求TUser必须实现IUser<TKey>接口——虽然你的User类继承自IdentityUser<int>（它已经实现了该接口），但通常是命名空间混淆、泛型声明方式不对，或者DI配置问题导致的。下面是具体的修复步骤：

1. 简化UserManager的声明方式 #

在ASP.NET Core Identity中，当你的User类已经继承自IdentityUser<int>（明确了主键类型为int），不需要显式指定TKey泛型参数，直接使用UserManager<User>即可：

private UserManager<User> _userManager;

UserManager<TUser>会自动从IdentityUser<int>中推断出主键类型为int，这样可以避免泛型参数匹配错误。

2. 检查命名空间的一致性 #

确保你的代码中所有Identity相关的类型都来自同一个框架版本：

• 确认User类继承的是**Microsoft.AspNetCore.Identity.IdentityUser<int>**（ASP.NET Core Identity），而不是旧ASP.NET Framework中的Microsoft.AspNet.Identity.EntityFramework.IdentityUser。
• 确认UserManager的引用来自Microsoft.AspNetCore.Identity命名空间，而非旧版本的命名空间。

3. 验证DI容器的Identity服务配置 #

在Program.cs（.NET 6+）或Startup.cs中，必须正确注册使用自定义User和IdentityRole<int>的Identity服务，否则DI无法正确解析UserManager<User>：

// .NET 6+ Program.cs示例
builder.Services.AddIdentity<User, IdentityRole<int>>(options => 
{
    options.SignIn.RequireConfirmedAccount = true;
    // 其他Identity配置项
})
.AddEntityFrameworkStores<BlogDbContext>()
.AddDefaultTokenProviders();

如果只需要核心身份验证功能，也可以使用AddIdentityCore：

builder.Services.AddIdentityCore<User>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddRoles<IdentityRole<int>>()
    .AddEntityFrameworkStores<BlogDbContext>()
    .AddDefaultTokenProviders();

4. 调整OnModelCreating的调用顺序 #

在你的BlogDbContext中，建议先调用base.OnModelCreating(builder)，再应用自定义配置。因为Identity会先初始化默认的表结构和关系，之后你的自定义配置才能正确覆盖或扩展这些设置：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder); // 先初始化Identity的默认配置
    builder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly());
    // 应用自定义配置
    builder.ApplyConfiguration(new UserConfiguration());
    builder.ApplyConfiguration(new UserDetailsConfiguration());
    // 配置一对一关系
    builder.Entity<Location>()
        .HasOne<UserDetails>(s => s.UserDetails)
        .WithOne(g => g.Location)
        .HasForeignKey<UserDetails>(ad => ad.LocationId);
    builder.Entity<User>()
        .HasOne<UserDetails>(s => s.UserDetails)
        .WithOne(g => g.User)
        .HasForeignKey<UserDetails>(ad => ad.UserId);
}

内容的提问来源于stack exchange，提问作者Анатолій Тимошенко