如何将EF Core模型及迁移迁移至拆分DbContext的新解决方案？

1. 迁移原历史迁移文件 #

直接把原项目Migrations目录下的所有文件（包括快照文件）复制到新方案里的迁移专用项目（也可按DbContext分组存放）。注意：绝对不能修改原迁移的MigrationId和TargetModel字段——这两个是EF识别数据库迁移状态的核心标识。如果模型的命名空间发生变化，仅需替换迁移文件Up/Down方法里实体的引用命名空间即可。

2. 配置每个拆分后的DbContext #

每个独立DbContext必须完成以下配置：

• 在OnConfiguring方法中指定连接字符串，同时设置迁移程序集（如果迁移文件不在DbContext所在项目）：

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      optionsBuilder.UseSqlServer(
          "你的数据库连接字符串",
          b => b.MigrationsAssembly("你的迁移项目名称"));
  }
  

• 在OnModelCreating方法里仅注册当前DbContext负责的实体，不要包含其他DbContext的模型：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<User>();
      modelBuilder.Entity<UserAddress>();
      // 只添加当前上下文管理的实体
  }
  

• DbSet<T>也仅声明当前上下文负责的实体。

3. 同步迁移历史表 #

EF的__EFMigrationsHistory表是全局共用的，所有DbContext都依赖它，需注意：

• 检查每个DbContext的模型快照，确保快照中的模型结构与原数据库对应表的结构完全一致，这样EF才能正确识别已有的迁移记录。
• 原迁移中涉及跨实体的操作（比如同时创建用户和订单表）无需拆分——这些操作已经在数据库中执行完毕，后续只需保证新迁移各自管理对应的实体即可。

4. 生成拆分后的初始迁移 #

针对每个DbContext单独生成迁移（Package Manager Console需选中对应的启动项目或迁移项目）：

# 针对UserContext生成初始拆分迁移
Add-Migration InitialSplit_User -Context UserContext -Project Your.Migration.Project

生成后打开迁移文件检查，若没有实体结构变化，迁移内容为空是正常现象——因为原数据库结构已经存在。随后执行迁移：

Update-Database -Context UserContext

这一步仅会让EF确认历史迁移记录，不会重复执行原迁移操作。

5. 后续迁移规范 #

• 每次仅针对单个DbContext生成迁移，确保每个迁移仅修改该上下文负责的实体。
• 禁止在多个DbContext中配置同一个实体，否则会导致EF元数据冲突。
• 跨DbContext的事务可通过IDbContextTransaction手动管理。

关键注意事项 #

• 禁止手动修改__EFMigrationsHistory表中的任何记录，否则EF将无法识别数据库的迁移状态。
• 操作前务必备份原数据库和迁移文件，避免数据丢失或迁移失败。
• 原迁移中的自定义SQL操作（比如创建视图、存储过程）需确认归属，可分配到对应的DbContext迁移中，或单独维护。

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