EF Core持久化DDD值对象集合为JSON时的主键问题

兄弟，这个坑我之前踩过！EF Core之所以报这个错，是因为它默认把你的PhoneNumber当成了需要独立持久化的实体，而实体必须要有主键。但咱们都知道值对象是聚合根的一部分，根本不需要主键，所以得告诉EF Core它的身份——用**拥有实体（Owned Entity）**特性来标记就对了！

1. 先确保PhoneNumber符合值对象的核心特性 #

值对象的本质是值相等性而非身份标识，所以必须是不可变的。推荐用C# 9+的record类型（自动实现值相等性），或者手动重写相等判断逻辑：

// 推荐：用record实现值对象
public record PhoneNumber(string CountryCode, string Number);

// 传统类实现方式（可选）
public class PhoneNumber
{
    // 私有构造，确保只能通过工厂方法创建，保证不可变性
    private PhoneNumber(string countryCode, string number)
    {
        CountryCode = countryCode;
        Number = number;
    }

    // 只读属性，禁止外部修改
    public string CountryCode { get; }
    public string Number { get; }

    // 工厂方法，可添加参数验证逻辑
    public static PhoneNumber Create(string countryCode, string number)
    {
        if (string.IsNullOrWhiteSpace(countryCode))
            throw new ArgumentException("国家代码不能为空");
        return new PhoneNumber(countryCode, number);
    }

    // 重写相等判断，基于属性值比较
    public override bool Equals(object? obj)
    {
        if (obj is not PhoneNumber other) return false;
        return CountryCode == other.CountryCode && Number == other.Number;
    }

    public override int GetHashCode()
    {
        return HashCode.Combine(CountryCode, Number);
    }
}

2. 告诉EF Core这是值对象集合 #

有两种配置方式，选一种就行：

方式一：用DataAnnotations标记（简单直接） #

在PhoneNumber类上加[Owned]特性，再在实体的集合属性上加[CollectionOwnership]（EF Core 5+支持）：

using System.ComponentModel.DataAnnotations.Schema;

// 标记为值对象（拥有实体）
[Owned]
public record PhoneNumber(string CountryCode, string Number);

// 你的实体类示例
public class Customer
{
    public Guid Id { get; set; }
    public string FullName { get; set; }

    // 值对象集合，标记为集合拥有关系
    [CollectionOwnership]
    public List<PhoneNumber> PhoneNumbers { get; set; } = new();
}

方式二：用Fluent API配置（更灵活，推荐） #

在你的DbContext的OnModelCreating方法里，显式配置聚合根与值对象的从属关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Customer>(entity =>
    {
        // 配置Customer拥有多个PhoneNumber值对象
        entity.OwnsMany(e => e.PhoneNumbers, phoneConfig =>
        {
            // 可自定义列属性，比如长度、列名，完全不需要配置主键
            phoneConfig.Property(p => p.CountryCode).HasMaxLength(3).HasColumnName("Country_Code");
            phoneConfig.Property(p => p.Number).HasMaxLength(20);
        });
    });
}

3. 重新执行迁移命令 #

现在再运行Add-Migration InitialCreate，EF Core就会正确识别PhoneNumber是值对象集合了。它会自动生成关联表（默认表名类似CustomerPhoneNumbers），用聚合根的主键（比如CustomerId）加上一个内部索引列来存储集合项，完全不需要给PhoneNumber添加主键，完美符合DDD的设计原则！

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