如何在现有EF项目中正确配置第二个DbContext并生成专属迁移

报错根因 #

这个问题的核心原因是EF Core默认会扫描项目内所有带数据映射特性的实体类型纳入当前上下文的模型构建流程，不会自动按DbContext做实体隔离。你虽然为GeoDbContext单独实现了OnConfiguring和OnModelCreating，但没有限制它的实体扫描范围，导致构建GeoDbContext模型时，加载了原本归ApplicationDbContext管理的、带多个[Key]属性的实体——这些实体的复合主键配置只写在ApplicationDbContext的OnModelCreating里，GeoDbContext没有对应配置，自然就抛出“复合主键必须通过HasKey配置”的错误。

具体配置步骤 #

1. 隔离两个DbContext的实体加载范围 #

首先要让每个DbContext只加载自己管辖的实体，不要扫描无关类型，两种方案选其一即可：

• 方案1：在GeoDbContext的OnModelCreating开头，显式忽略所有属于ApplicationDbContext的实体

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 逐个排除所有归ApplicationDbContext管理的实体
    modelBuilder.Ignore<User>();
    modelBuilder.Ignore<Order>();
    // ... 其他Application侧的实体全部加Ignore

    // 之后再写GeoDbContext自己的实体配置
    modelBuilder.Entity<UserLocation>().ToTable("user_locations");
    base.OnModelCreating(modelBuilder);
}

• 方案2：关闭默认全量扫描，显式注册当前上下文需要加载的实体（适合实体数量多的场景）

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 只显式注册当前上下文管辖的实体
    modelBuilder.Entity<UserLocation>();
    // 加载实体配置时，按命名空间过滤，只加载Geo侧的配置类，避免加载Application侧的映射配置
    modelBuilder.ApplyConfigurationsFromAssembly(
        typeof(GeoDbContext).Assembly,
        configType => configType.Namespace == "YourProject.Geo.Entities.Configs"
    );
    
    base.OnModelCreating(modelBuilder);
}

建议给ApplicationDbContext也做同样的范围限制，避免后续生成它的迁移时扫到Geo侧的实体引发新的冲突。

2. 隔离两个上下文的迁移存储路径 #

EF Core默认会把所有上下文的迁移文件存到同一个Migrations目录，也会引发模型扫描冲突，需要给两个上下文指定独立的迁移存储位置和迁移历史表名：
修改服务注册代码：

.AddDbContext<ApplicationDbContext>(m => m.UseMySql(
    ApplicationConn, 
    ServerVersion.AutoDetect(ApplicationConn),
    opt => opt
        .MigrationsHistoryTable("__EFMigrationsHistory_Application")
        .MigrationsOutputPath("Migrations/Application")
))
.AddDbContext<GeoDbContext>(m => m.UseNpgsql(
    GeoConn,
    opt => opt
        .MigrationsHistoryTable("__EFMigrationsHistory_Geo")
        .MigrationsOutputPath("Migrations/Geo")
));

如果不想改注册代码，生成迁移时手动指定输出目录也可以：

# 生成GeoDbContext的迁移时指定独立目录
Add-Migration addLocation -Context GeoDbContext -OutputDir Migrations/Geo

3. 重新生成迁移 #

先删除之前执行失败生成的空迁移文件，重新执行迁移命令即可正常生成GeoDbContext对应的迁移，不会再触发Application侧实体的校验错误。

提示：如果后续需要在两个上下文里复用同一个实体类型，必须在各自的OnModelCreating里单独完成该实体的主键、映射关系配置，不能只在一个上下文里配置。

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