Entity Framework跨库同名表实体注解引发类冲突报错

开发ASP.NET应用使用Entity Framework时，需要同时接入两个独立数据库：

• 两个库中存在同名数据表TBL_EMPRESAS
• 该表分别对应两个映射实体类：EmpresaDomain、EmpresaAuthenticationDomain
• 两个实体均配置了指向TBL_EMPRESAS的Table注解，主键定义一致，但其余字段结构存在差异
• 两个实体分属不同的DbContext，分别映射对应数据库
  发起数据请求时Entity Framework抛出如下异常：

Cannot use table 'TBL_EMPRESAS' for entity type 'EmpresaDomain' since it is being used for entity type 'EmpresaAuthenticationDomain' and potentially other entity types, but there is no linking relationship. Add a foreign key to 'EmpresaDomain' on the primary key properties and pointing to the primary key on another entity type mapped to 'TBL_EMPRESAS'.
中文释义：无法将表'TBL_EMPRESAS'用于实体类型'EmpresaDomain'，因为该表已被实体类型'EmpresaAuthenticationDomain'及可能的其他实体类型使用，且实体间不存在关联关系。请在'EmpresaDomain'的主键属性上添加外键，指向映射到'TBL_EMPRESAS'的其他实体类型的主键。

Entity Framework默认会在模型构建阶段扫描所有可识别的映射实体，即使实体分属不同DbContext，如果未做模型隔离，框架会将两个实体归入同一个模型元数据做合法性校验，识别到同一个表名映射了多个无关联关系的实体时，就会抛出多实体映射同表的错误。

按优先级从高到低选择以下方案即可修复：

• 方案1：在每个DbContext的OnModelCreating方法中显式注册当前上下文需要的实体，同时显式忽略不属于当前上下文的实体，阻断自动扫描带来的元数据污染。
  注意：不要仅依赖实体类上的[Table("TBL_EMPRESAS")]全局注解完成映射，这类全局特性会被所有上下文的模型扫描识别，是触发本次冲突的核心诱因之一。
  示例配置代码：

  // 映射业务库、对应EmpresaDomain实体的DbContext
  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      base.OnModelCreating(modelBuilder);
      // 显式注册当前上下文管辖的实体映射关系
      modelBuilder.Entity<EmpresaDomain>().ToTable("TBL_EMPRESAS");
      // 显式忽略属于认证库上下文的实体，不纳入当前上下文的模型构建流程
      modelBuilder.Ignore<EmpresaAuthenticationDomain>();
      
      // 其余实体映射配置...
  }
  
  // 映射认证库、对应EmpresaAuthenticationDomain实体的DbContext
  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      base.OnModelCreating(modelBuilder);
      modelBuilder.Entity<EmpresaAuthenticationDomain>().ToTable("TBL_EMPRESAS");
      modelBuilder.Ignore<EmpresaDomain>();
      
      // 其余实体映射配置...
  }
  

• 方案2：如果使用EF Core 2.0及以上版本，可实现自定义IModelCacheKeyFactory，为两个连接不同数据库的DbContext生成独立的模型缓存键，确保两个上下文的模型元数据完全独立构建、互不干扰，避免跨上下文的表映射校验冲突。
• 方案3：关闭EF的默认实体自动发现功能，所有实体映射均在对应DbContext中手动显式注册，从根源上避免框架自动扫描到不属于当前上下文的实体。

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