EF Core 8多Schema数据库迁移异常：单Context生成跨Schema迁移

1. 严格隔离DbContext的实体映射范围 #

• 检查DbContext定义：CrmDbContext里只能包含CRM Schema相关的DbSet，OrderingDbContext同理，绝对不能在一个Context里引入另一个Schema的实体。
• 如果使用IEntityTypeConfiguration配置实体，加载配置时要过滤范围，避免把所有实体配置都加到当前Context：

  // CrmDbContext的OnModelCreating方法
  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      // 只加载命名空间含"Crm"的实体配置类
      modelBuilder.ApplyConfigurationsFromAssembly(
          typeof(CrmDbContext).Assembly,
          type => type.Namespace?.Contains("Crm") == true);
      // 设置默认Schema为crm
      modelBuilder.HasDefaultSchema("crm");
  }
  

2. 单独配置迁移历史表与连接字符串 #

• 每个DbContext的连接字符串必须指定专属的SearchPath，比如Crm的连接字符串加;SearchPath=crm，Ordering的加;SearchPath=ordering，防止EF Core跨Schema扫描表。
• 在DbContext配置中显式指定唯一的迁移历史表，避免和另一个Context的迁移表冲突：

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      optionsBuilder.UseNpgsql(YourConnectionString, opts =>
      {
          // 给CRM的迁移历史表单独命名并指定Schema
          opts.MigrationsHistoryTable("__EFMigrationsHistory_Crm", "crm");
      });
  }
  

  注意：两个Context的迁移历史表名称要区分开，比如一个叫__EFMigrationsHistory_Crm，另一个叫__EFMigrationsHistory_Ordering。

3. 检查IDesignTimeDbContextFactory的正确性 #

• 确保工厂类只返回对应DbContext的实例，配置要和DbContext内部的设置完全一致，不要在工厂里误加其他Schema的配置：

  public class CrmDbContextFactory : IDesignTimeDbContextFactory<CrmDbContext>
  {
      public CrmDbContext CreateDbContext(string[] args)
      {
          var optionsBuilder = new DbContextOptionsBuilder<CrmDbContext>();
          var connStr = "Host=localhost;Database=yourdb;Username=postgres;Password=xxx;SearchPath=crm";
          optionsBuilder.UseNpgsql(connStr, opts =>
          {
              opts.MigrationsHistoryTable("__EFMigrationsHistory_Crm", "crm");
          });
  
          return new CrmDbContext(optionsBuilder.Options);
      }
  }
  

• 工厂类要和对应的DbContext在同一个程序集，确保EF Core能扫描到它。

4. 执行迁移时指定专属输出目录 #

生成迁移时必须用--output-dir指定独立目录，把两个Schema的迁移文件彻底分开，避免EF Core混淆：

# 生成CRM的初始迁移，存到Migrations/CrmMigrations目录
dotnet ef migrations add InitialCrm --context CrmDbContext --output-dir Migrations/CrmMigrations

# 生成Ordering的初始迁移，存到Migrations/OrderingMigrations目录
dotnet ef migrations add InitialOrdering --context OrderingDbContext --output-dir Migrations/OrderingMigrations

5. 排查实体共享的隐藏问题 #

• 检查所有实体类，确认没有被两个DbContext同时引用（比如不小心在两个Context里都添加了同一个DbSet）。
• 如果使用了延迟加载代理或者全局查询过滤器，确认这些配置不会导致EF Core加载其他Schema的实体。

6. 重置迁移（若之前已混乱） #

如果之前的迁移已经出现交叉污染，建议彻底重置：

1. 删除项目中所有迁移目录下的文件
2. 登录PostgreSQL，删除数据库里的__EFMigrationsHistory_Crm、__EFMigrationsHistory_Ordering表
3. 按照上述步骤重新生成迁移

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