从EF6迁移至EF Core及AspNetCore.Identity的现有数据库架构问题

背景 #

• 正在推进大型多租户应用的升级：从.NET Framework 4.8迁移至.NET 6，同步完成EF6到EF Core 7、Asp.Net Identity到Microsoft.AspNetCore.Identity的切换
• 原项目依赖EF6 Code First自动迁移，EF Core仅支持手动迁移；因数据库数量多、数据量大且要求零停机，必须沿用现有数据库及架构，无法通过新建库迁移数据的方式处理

核心需求 #

• 生成仅包含框架升级引发的数据库变更的EF初始迁移，优先在现有数据库执行，后续再处理业务模型变更对应的新迁移
• 框架升级带来的明确变更：AspNetUsers表新增NormalisedUsername、NormalisedEmail等Identity相关字段
• 暂需忽略EF Core对旧架构的自动调整（如datetime列转datetime2、外键/索引名称修改），需明确这些忽略对应用运行的影响
• 新建租户数据库的初始迁移可延后处理

待解决问题 #

1. 如何精准创建仅包含框架升级变更的EF初始迁移？
2. 是否必须手动对比新旧架构编写脚本，还是有工具/技巧可自动生成？

解决方案 #

1. 生成框架升级专属迁移脚本 #

步骤一：搭建对比基准

• 从现有生产库导出结构完全一致的测试库（仅需结构，可带少量测试数据）
• 基于升级后的代码栈（.NET 6+EF Core 7+新Identity）创建临时空数据库，让EF Core自动生成完整的新架构（含Identity新字段、EF Core默认的列类型/命名规则）

步骤二：生成并清理迁移

• 用Scaffold-DbContext分别将旧测试库和新空库的架构反向生成为两个临时DbContext
• 基于新代码的DbContext生成初始迁移：

  Add-Migration InitialFrameworkUpgrade -Context YourNewDbContext
  

• 打开生成的迁移文件，手动清理冗余变更：
  • 保留Identity相关的字段新增、索引创建（如IX_AspNetUsers_NormalizedUserName）
  • 删除EF Core自动生成的datetime→datetime2、外键/索引重命名等非必要调整
  • 最终确保迁移仅包含框架升级必须的Identity架构变更

步骤三：测试验证

• 在测试库执行迁移脚本，验证应用连接及核心功能（尤其是Identity相关的登录、用户管理）是否正常

2. 忽略非必要变更的影响说明 #

• datetime→datetime2：SQL Server中datetime2是datetime的超集，现有datetime列的数据可完全兼容EF Core的datetime2读取；若要保持原有列类型，可在实体配置中显式指定：

  modelBuilder.Entity<YourEntity>()
      .Property(e => e.CreatedTime)
      .HasColumnType("datetime");
  

• 外键/索引名称变更：EF Core默认命名规则与EF6不同，但只要应用不直接依赖数据库层面的外键/索引名称（仅通过EF Core实体关系操作），忽略名称变更完全不影响运行；若存在直接操作数据库的SQL语句，则需同步调整或在实体配置中指定原有命名

3. 后续新建数据库处理 #

等现有数据库迁移完成后，针对空数据库生成完整初始迁移：

Add-Migration InitialEmptyTenantDb -Context YourNewDbContext -IgnoreChanges

之后手动补充完整架构创建语句，或基于已迁移完成的生产库反向生成脚本，用于新租户数据库的初始化

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