EF Core 8 Database First集成Identity服务异常求助

核心问题本质 #

你遇到的所有异常都是Identity框架默认实体映射与Database First生成的自定义实体/配置冲突导致的：

• 继承IdentityDbContext时，框架自动注册默认Identity实体（如IdentityRole<Guid>）并绑定默认表名，但你手动添加了自己生成的AspNetRole等实体，造成同一张表被多个实体类型关联
• UserManager<AppUser>依赖的AppUser未正确映射到数据库的AspNetUsers表，框架默认查找AppUser表引发不存在的错误
• 用户角色关联表同时存在框架默认的字典映射和自定义配置，触发表重复绑定的冲突

分步解决方案 #

1. 修正DbContext的泛型参数 #

IdentityDbContext的泛型参数必须统一使用你Database First生成的自定义实体，不能混合框架默认类型：

// 原错误写法：混合了自定义AspNetUser与框架默认IdentityRole<Guid>
// public partial class MyUserContext : IdentityDbContext<AspNetUser, IdentityRole<Guid>, Guid>

// 修改为：全部使用自定义生成的实体类型
public partial class MyUserContext : IdentityDbContext<
    AspNetUser, 
    AspNetRole, 
    Guid, 
    AspNetUserClaim, 
    AspNetUserRole, 
    AspNetUserLogin, 
    AspNetRoleClaim, 
    AspNetUserToken>

注意：需确保已通过Database First生成AspNetUserRole实体（之前代码用Dictionary临时映射，必须替换为实体类）

2. 移除重复的DbSet声明 #

IdentityDbContext已内置所有Identity实体的DbSet，手动重复声明会引发冲突，删除以下代码：

// 这些DbSet已由IdentityDbContext提供，无需重复定义
public virtual DbSet<AspNetRole> AspNetRoles { get; set; }
public virtual DbSet<AspNetRoleClaim> AspNetRoleClaims { get; set; }
public virtual DbSet<AspNetUser> AspNetUsers { get; set; }
public virtual DbSet<AspNetUserClaim> AspNetUserClaims { get; set; }
public virtual DbSet<AspNetUserLogin> AspNetUserLogins { get; set; }
public virtual DbSet<AspNetUserToken> AspNetUserTokens { get; set; }

3. 调整用户-角色关联配置 #

替换原Dictionary映射方式，改用实体类关联：

// 删除原User-Role的Dictionary映射代码，添加以下配置
modelBuilder.Entity<AspNetUserRole>(entity =>
{
    entity.HasKey(e => new { e.UserId, e.RoleId });
    entity.ToTable("AspNetUserRoles");
    entity.HasIndex(e => e.RoleId, "IX_AspNetUserRoles_RoleId");

    entity.HasOne(d => d.Role)
        .WithMany(p => p.AspNetUserRoles)
        .HasForeignKey(d => d.RoleId);

    entity.HasOne(d => d.User)
        .WithMany(p => p.AspNetUserRoles)
        .HasForeignKey(d => d.UserId);
});

同时修改AspNetUser和AspNetRole的实体配置：

// AspNetUser配置中更新关联
modelBuilder.Entity<AspNetUser>(entity =>
{
    // 保留原有配置，添加以下行替换原Roles关联
    entity.HasMany(d => d.AspNetUserRoles)
        .WithOne(p => p.User)
        .HasForeignKey(d => d.UserId);
});

// AspNetRole配置中更新关联
modelBuilder.Entity<AspNetRole>(entity =>
{
    // 保留原有配置，添加以下行替换原Users关联
    entity.HasMany(d => d.AspNetUserRoles)
        .WithOne(p => p.Role)
        .HasForeignKey(d => d.RoleId);
});

4. 统一UserManager的实体类型 #

确保UserManager使用的实体与数据库映射一致：

// 方案1：若自定义了AppUser，让它继承AspNetUser
public class AppUser : AspNetUser { }

// 方案2：直接使用AspNetUser作为UserManager的泛型参数
services.AddDefaultIdentity<AspNetUser>()
    .AddEntityFrameworkStores<MyUserContext>();

5. 修正数据库提供器配置 #

异常显示使用Postgres，但DbContext配置用了UseSqlServer，在Program.cs中修正：

builder.Services.AddDbContext<MyUserContext>(options =>
    options.UseNpgsql(builder.Configuration.GetConnectionString("MyUserConnection")));

验证步骤 #

1. 清理项目并重新生成
2. 检查OnModelCreating中无重复的表映射配置
3. 启动项目测试UserManager等服务调用

内容的提问来源于stack exchange，提问作者tan truong the