Asp.net Identity中如何为用户表与角色表设置不同类型主键

我之前也遇到过完全一样的场景——ASP.NET Identity默认强制用户和角色使用相同类型的主键，但实际开发中确实有需求要让用户用Guid、角色用int。下面是我验证过的完整解决方案，一步步来解决你的问题：

1. 自定义所有Identity实体 #

核心问题在于默认的IdentityUserRole<TKey>只支持单一主键类型，所以我们需要自定义用户-角色关联实体，同时适配两边不同的主键类型：

// 用户实体：主键用Guid，继承IdentityUser<Guid>
public class User : IdentityUser<Guid>
{
    // 自定义属性示例
    public string FullName { get; set; }
    // 导航属性：关联用户-角色表
    public ICollection<UserRole> UserRoles { get; set; } = new List<UserRole>();
}

// 角色实体：主键用int，继承IdentityRole<int>
public class Role : IdentityRole<int>
{
    // 自定义属性示例
    public string Description { get; set; }
    // 导航属性：关联用户-角色表
    public ICollection<UserRole> UserRoles { get; set; } = new List<UserRole>();
}

// 用户声明：关联用户的Guid主键
public class UserClaim : IdentityUserClaim<Guid>
{
}

// 用户登录记录：关联用户的Guid主键
public class UserLogin : IdentityUserLogin<Guid>
{
}

// 角色声明：关联角色的int主键
public class RoleClaim : IdentityRoleClaim<int>
{
}

// 用户令牌：关联用户的Guid主键
public class UserToken : IdentityUserToken<Guid>
{
}

// 关键：自定义用户-角色关联实体，支持不同类型的主键
public class UserRole
{
    public Guid UserId { get; set; } // 对应用户的Guid主键
    public int RoleId { get; set; } // 对应角色的int主键

    // 导航属性
    public User User { get; set; }
    public Role Role { get; set; }
}

2. 配置DbContext #

默认的IdentityDbContext强制用户和角色主键类型一致，所以我们直接继承DbContext，手动配置所有Identity实体的关系：

public class AppDbContext : DbContext
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options)
    {
    }

    // 添加所有Identity相关的DbSet
    public DbSet<User> Users { get; set; }
    public DbSet<Role> Roles { get; set; }
    public DbSet<UserClaim> UserClaims { get; set; }
    public DbSet<UserLogin> UserLogins { get; set; }
    public DbSet<RoleClaim> RoleClaims { get; set; }
    public DbSet<UserToken> UserTokens { get; set; }
    public DbSet<UserRole> UserRoles { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);

        // 配置用户-角色表的复合主键
        modelBuilder.Entity<UserRole>()
            .HasKey(ur => new { ur.UserId, ur.RoleId });

        // 配置用户和用户-角色表的一对多关系
        modelBuilder.Entity<UserRole>()
            .HasOne(ur => ur.User)
            .WithMany(u => u.UserRoles)
            .HasForeignKey(ur => ur.UserId)
            .OnDelete(DeleteBehavior.Cascade);

        // 配置角色和用户-角色表的一对多关系
        modelBuilder.Entity<UserRole>()
            .HasOne(ur => ur.Role)
            .WithMany(r => r.UserRoles)
            .HasForeignKey(ur => ur.RoleId)
            .OnDelete(DeleteBehavior.Cascade);

        // 可选：修改默认表名（比如把AspNetUsers改成Users）
        modelBuilder.Entity<User>().ToTable("Users");
        modelBuilder.Entity<Role>().ToTable("Roles");
        modelBuilder.Entity<UserRole>().ToTable("UserRoles");
    }
}

3. 配置Identity服务 #

在Program.cs中，我们需要用AddIdentityCore<TUser>替代默认的AddIdentity，手动添加角色支持：

var builder = WebApplication.CreateBuilder(args);

// 注册DbContext
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

// 配置Identity服务，适配不同主键类型
builder.Services.AddIdentityCore<User>(options => 
{
    options.SignIn.RequireConfirmedAccount = true;
    // 可以在这里添加密码、锁定等规则
})
.AddRoles<Role>() // 添加角色支持，指定Role类型
.AddRoleManager<RoleManager<Role>>()
.AddSignInManager<SignInManager<User>>()
.AddEntityFrameworkStores<AppDbContext>()
.AddDefaultTokenProviders();

// 添加授权服务
builder.Services.AddAuthorization(options =>
{
    // 示例：添加管理员专属策略
    options.AddPolicy("AdminOnly", policy => policy.RequireRole("Admin"));
});

// 其他服务配置...

var app = builder.Build();

// 中间件配置
app.UseAuthentication();
app.UseAuthorization();

app.Run();

为什么你之前的代码会报错？ #

你尝试的public class Role : IdentityRole<int, UserRole>是错误的——IdentityRole的泛型定义要求TUserRole必须是IdentityUserRole<TKey>类型（也就是和角色主键类型一致），但你的用户主键是Guid、角色是int，默认的IdentityUserRole<TKey>无法同时适配两个不同类型的主键，所以必须自定义UserRole实体来解决这个冲突。

这样配置后，你就能同时拥有Guid主键的用户和int主键的角色，且Identity的核心功能（登录、授权、角色管理等）都能正常工作。

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