如何在ASP.NET MVC的OnModelCreating()中通过迁移添加用户种子数据并分配角色

首先明确核心原则：EF Core 的 HasData 种子数据必须显式指定主键，不能依赖数据库自动生成ID。因为种子数据是静态初始化数据，需要固定的主键值来确保迁移和数据初始化的一致性，避免每次运行都生成新ID导致重复数据或冲突。

按照这个原则，你可以按以下步骤在 OnModelCreating 中完成角色、用户及角色分配的种子数据初始化：

1. 提前生成固定GUID作为ID #

为角色和用户生成固定的GUID（可用Visual Studio的GUID生成器或在线工具生成），确保每次初始化都使用同一个值。

2. 按顺序添加种子数据 #

遵循角色 → 用户 → 用户-角色关联的顺序添加，因为关联表依赖前两者的主键。

完整代码示例：

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

    // 定义固定ID
    var adminRoleId = "300c6b87-3d71-407c-8379-53e4b3091a8d";
    var adminUserId = "a1f5c2d8-7b9e-4c3a-8d2e-1b3c4d5e6f7a";

    // 1. 种子角色数据
    modelBuilder.Entity<IdentityRole>().HasData(
        new IdentityRole
        {
            Id = adminRoleId,
            Name = "Administrator",
            NormalizedName = "ADMINISTRATOR",
            ConcurrencyStamp = Guid.NewGuid().ToString()
        }
        // 可在此添加更多角色
    );

    // 2. 种子用户数据（需填充IdentityUser必填字段）
    var adminUser = new IdentityUser
    {
        Id = adminUserId,
        UserName = "admin@example.com",
        NormalizedUserName = "ADMIN@EXAMPLE.COM",
        Email = "admin@example.com",
        NormalizedEmail = "ADMIN@EXAMPLE.COM",
        EmailConfirmed = true,
        PasswordHash = BCrypt.Net.BCrypt.HashPassword("YourStrongPassword123!") // 提前哈希密码
    };
    modelBuilder.Entity<IdentityUser>().HasData(adminUser);

    // 3. 种子用户-角色关联数据
    modelBuilder.Entity<IdentityUserRole<string>>().HasData(
        new IdentityUserRole<string>
        {
            UserId = adminUserId,
            RoleId = adminRoleId
        }
    );
}

关键注意事项 #

• 显式指定ID：这是EF Core种子数据的硬性要求，否则迁移时无法识别已有种子记录，会导致重复插入。
• 密码哈希：绝对不能存明文密码，必须用Identity框架兼容的哈希方式（示例用BCrypt，也可使用PasswordHasher<IdentityUser>生成哈希值）。
• Normalized字段：Identity框架依赖NormalizedUserName和NormalizedEmail做唯一性校验与查询，必须设置为大写形式。
• ConcurrencyStamp：可设置为固定GUID或动态生成，只要确保每个角色/用户的该值唯一即可。

为什么不依赖自动生成ID？ #

数据库自动生成的ID（如自增列）在种子数据中无法提前确定，EF Core无法在迁移时记录这些ID，后续更新种子数据时会出现主键冲突或无法匹配现有记录的问题，显式指定固定ID是唯一可靠的方式。

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