EF Core 2.0跨程序集创建一对一关系及表拆分实现方法

首先，咱们得明确EF Core表拆分的核心前提：两个实体必须映射到同一张数据库表，共享同一个主键，并且互相配置双向导航属性。针对你在MyApp.Core和MyApp.CommerceService两个类库的场景，我给你梳理具体实现步骤：

1. 补全实体的双向导航定义 #

首先得让两个实体的导航关系是双向的，并且主键字段能对应上（表拆分要求共享主键）：

在MyApp.Core的User类： #

public partial class User 
{ 
    public long UserId { get; set; } 
    public string Username { get; set; } 
    public string Email { get; set; } 
    // 导航到关联的Customer实体
    public Customer Customer { get; set; } 
}

在MyApp.CommerceService的Customer类： #

public partial class Customer 
{ 
    // 注意：主键类型要和User的UserId完全一致，表拆分时它会和UserId共用同一列
    public long CustomerId { get; set; } 
    public string CustomerNumber { get; set; } 
    public decimal Balance { get; set; }
    // 导航回关联的User实体（双向引用是表拆分的关键）
    public User User { get; set; } 
}

2. 处理程序集引用（避免循环依赖） #

因为两个实体互相依赖，绝对不能让MyApp.Core和MyApp.CommerceService直接双向引用（会导致循环依赖编译错误）。推荐的做法是：

• 新建一个单独的类库（比如MyApp.DataAccess）来存放EF Core的DbContext
• 让MyApp.DataAccess同时引用MyApp.Core和MyApp.CommerceService，这样就能同时访问两个实体，完美规避循环依赖问题

如果你的DbContext已经存在于其中一个类库（比如MyApp.Core），那只能让MyApp.Core引用MyApp.CommerceService，反过来的引用是不允许的。

3. 配置EF Core的表拆分映射 #

在DbContext的OnModelCreating方法里，明确配置两个实体映射到同一张表，并且关联主键和导航关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置User实体基础映射
    modelBuilder.Entity<User>(entity =>
    {
        entity.ToTable("Users"); // 指定共用的表名
        entity.HasKey(u => u.UserId); // 主键定义
        
        // 配置User与Customer的一对一关系
        entity.HasOne(u => u.Customer)
              .WithOne(c => c.User)
              .HasForeignKey<Customer>(c => c.CustomerId); // 用Customer的主键作为外键关联User的主键
    });

    // 配置Customer实体映射到同一张表（表拆分的核心配置）
    modelBuilder.Entity<Customer>(entity =>
    {
        entity.ToTable("Users"); // 必须和User指定同一个表名
        entity.HasKey(c => c.CustomerId); // 主键定义
        
        // 可以额外配置字段规则，比如必填、长度限制
        entity.Property(c => c.CustomerNumber).IsRequired().HasMaxLength(50);
    });
}

4. 验证与使用 #

配置完成后，你可以通过EF Core迁移生成数据库结构，会发现只有一张Users表，包含两个实体的所有字段。

使用时和普通的一对一实体操作完全一致：

// 创建带Customer的User
var newUser = new User
{
    Username = "jane_smith",
    Email = "jane@example.com",
    Customer = new Customer
    {
        CustomerNumber = "CUST-002",
        Balance = 200.75m
    }
};

dbContext.Users.Add(newUser);
await dbContext.SaveChangesAsync();

// 查询时同时加载关联的Customer
var targetUser = await dbContext.Users
                               .Include(u => u.Customer)
                               .FirstOrDefaultAsync(u => u.UserId == 1);

关键注意事项 #

• 主键必须完全匹配：两个实体的主键类型、数据库列名（或通过配置映射）必须一致，否则表拆分无法生效
• 迁移命令要指定正确的项目：如果使用EF Core迁移，要确保命令能扫描到所有实体所在的程序集，比如在Package Manager Console中执行：

  Add-Migration InitialTableSplit -Project MyApp.DataAccess -StartupProject MyApp.Web
  

• 避免重复配置表名：两个实体必须明确指定同一个表名，EF Core不会自动推断表拆分的表名

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