将现有Microsoft.AspNet.Identity数据库（EF 6）迁移至Microsoft.AspNetCore.Identity（EF Core）

嘿，刚好我之前帮团队做过从ASP.NET MVC Identity到Core Identity的迁移，这个场景我熟！虽然没有完全一键生成适配现有数据库的迁移工具，但有一套靠谱的步骤可以帮你对接，不用从零重建表结构，下面给你详细说：

1. 先在Core项目中对齐Identity模型与旧数据库 #

• 首先创建你的自定义Identity实体类，比如ApplicationUser和ApplicationRole，要严格对应旧数据库的字段：
  • 旧表AspNetUsers的主键如果是Guid，那ApplicationUser的Id就设为public Guid Id { get; set; }；如果是int就对应int类型。
  • 把旧表中存在的字段（比如UserName、Email、PasswordHash、PhoneNumber等）都在实体类中定义，包括你自己加的自定义字段。
• 接着在你的DbContext中用Fluent API映射到旧表名和列名（如果和Core默认不一致的话），比如：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    // 映射AspNetUsers到旧表名（如果默认名不一样的话）
    modelBuilder.Entity<ApplicationUser>().ToTable("AspNetUsers");
    // 映射自定义列名（如果需要）
    modelBuilder.Entity<ApplicationUser>()
        .Property(u => u.UserName)
        .HasColumnName("UserName");
    // 同理处理Role等其他表
}

2. 生成初始迁移并手动修改适配现有数据库 #

• 先运行迁移生成命令：
  • Package Manager Console: Add-Migration InitialIdentityMigration
  • .NET CLI: dotnet ef migrations add InitialIdentityMigration
• 打开生成的迁移文件（在Migrations文件夹下），删除所有CreateTable语句——因为我们要对接已有的表，不是新建。
• 然后根据旧表的情况，添加需要的修改：
  • 如果旧表缺少Core Identity必需的字段（比如NormalizedUserName、NormalizedEmail、SecurityStamp），添加AddColumn语句。
  • 调整索引：Core Identity默认会给NormalizedUserName、NormalizedEmail加唯一索引，旧表如果没有的话，添加CreateIndex语句。
  • 检查外键：比如AspNetUserRoles的外键是否和Core的要求一致，必要时添加或修改外键约束。

3. 验证并应用迁移 #

• 先生成SQL脚本预览，确认不会破坏现有数据：
  • Package Manager Console: Update-Database -Script
  • .NET CLI: dotnet ef migrations script
• 仔细检查脚本，确保没有删除现有数据、没有错误的修改，确认无误后再应用迁移：
  • Package Manager Console: Update-Database
  • .NET CLI: dotnet ef database update

4. 关键注意事项 #

• 密码哈希兼容性：ASP.NET MVC Identity和Core Identity默认都使用PBKDF2算法，大部分情况下是兼容的，但要确保Core项目的密码哈希配置和旧项目一致。可以在Program.cs/Startup.cs中明确配置：

services.AddIdentity<ApplicationUser, ApplicationRole>()
    .AddEntityFrameworkStores<YourDbContext>()
    .AddDefaultTokenProviders()
    .AddPasswordHasher<PasswordHasher<ApplicationUser>>();

• 主键类型一致性：一定要保证Core实体的主键类型和旧数据库表的主键类型完全一致，否则会出现主键不匹配的错误。
• 自定义字段的处理：如果旧表有自定义字段，要在Core的实体类中同步定义，并且在迁移中确保这些列不会被误删或修改。

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