EF Core如何映射领域模型中作为值对象的带主键地址实体？

核心结论 #

不能将Address设为拥有实体（Owned Entity），因为拥有实体与父实体强绑定，会随订单新增/更新，不符合复用现有CustomerAddresses表的需求。我们用EF Core影子属性实现映射，既保持领域层干净，又能让EF识别现有地址。

步骤1：保持领域模型不变 #

你的领域类无需修改，完全隔离仓储层细节：

public class Order
{
    public long Id { get; set; }
    public Address DeliveryAddress { get; set; }
}

public class Address
{
    public string Street { get; set; }
    public string PostalCode { get; set; }
    public string City { get; set; }
    public string Country { get; set; }
}

步骤2：DbContext配置（Fluent API） #

通过影子属性定义地址ID和外键，映射到CustomerAddresses表：

public class AppDbContext : DbContext
{
    public DbSet<Order> Orders { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置Order与DeliveryAddress的关联
        modelBuilder.Entity<Order>(entity =>
        {
            entity.HasKey(o => o.Id);
            // 用影子外键关联地址ID，领域层无感知
            entity.HasOne(o => o.DeliveryAddress)
                  .WithMany() // Address无反向导航到Order
                  .HasForeignKey("DeliveryAddressId")
                  .OnDelete(DeleteBehavior.NoAction); // 避免删除订单时删除地址
        });

        // 配置Address映射到CustomerAddresses表
        modelBuilder.Entity<Address>(entity =>
        {
            // 定义影子属性Id作为主键，对应数据库的Id列
            entity.Property<int>("Id");
            entity.HasKey("Id");

            // 指定映射到现有表
            entity.ToTable("CustomerAddresses");

            // 映射字段到数据库列
            entity.Property(a => a.Street).HasColumnName("Street");
            entity.Property(a => a.PostalCode).HasColumnName("PostalCode");
            entity.Property(a => a.City).HasColumnName("City");
            entity.Property(a => a.Country).HasColumnName("Country");

            // 可选：如果需要通过客户ID查询地址，添加影子属性映射IDCustomer列
            entity.Property<int>("IDCustomer");
        });
    }
}

步骤3：新增订单时复用现有地址 #

从数据库加载已存在的地址实例，赋值给订单即可，EF会自动关联并跳过地址新增：

// 加载客户ID为123对应的地址（示例）
var existingAddress = await dbContext.Set<Address>()
    .FirstOrDefaultAsync(a => EF.Property<int>(a, "IDCustomer") == 123);

// 或直接通过地址ID加载
// var existingAddress = await dbContext.Set<Address>().FindAsync(addressId);

var newOrder = new Order
{
    DeliveryAddress = existingAddress
};

dbContext.Orders.Add(newOrder);
await dbContext.SaveChangesAsync();

关键说明 #

1. 影子属性隔离仓储细节：Id和DeliveryAddressId仅在EF配置中存在，领域层完全看不到，避免了仓储层对领域模型的污染。
2. 独立实体而非拥有实体：将Address配置为独立实体，EF会识别已跟踪的地址实例，新增订单时仅插入订单记录，不会向CustomerAddresses表新增数据。
3. 灵活查询地址：通过EF.Property可访问影子属性IDCustomer，实现按客户ID查找地址的需求。

内容的提问来源于stack exchange，提问作者Álvaro García