EF Core配置Email值对象时迁移报错，求解决方案

问题根源 #

你同时给User.Email配置了拥有实体（OwnsOne）和值转换（HasConversion），这两种配置方式互斥：

• OwnsOne会把Email作为用户的拥有实体，将其内部属性（如Value）映射到Users表的嵌套列（默认命名为Email_Value）
• Property(x => x.Email).HasConversion(...)则是把Email当作单个值类型处理，试图直接将Email对象映射到数据库列

EF Core无法同时识别这两种逻辑，因此抛出关系无法确定的错误。

正确配置方式 #

移除针对Email的Property和HasConversion配置，仅保留OwnsOne，并通过OwnsOne的子构建器来配置Email内部属性的数据库映射规则：

修改后的UserConfiguration代码：

public class UserConfiguration : IEntityTypeConfiguration<User>
{
    public void Configure(EntityTypeBuilder<User> builder)
    {
        builder.ToTable(TableNames.Users);
        builder.HasKey(x => x.Id);

        // 配置Email为拥有实体，并设置内部属性的映射规则
        builder.OwnsOne(x => x.Email, emailBuilder =>
        {
            // 映射Email.Value到数据库列，自定义列名、长度并标记必填
            emailBuilder.Property(e => e.Value)
                .HasColumnName("Email")
                .HasMaxLength(Email.MaxLength)
                .IsRequired();

            // 给Email列添加唯一索引
            emailBuilder.HasIndex(e => e.Value).IsUnique();
        });

        // UserName的值类型转换配置无需修改
        builder
            .Property(x => x.UserName)
            .HasConversion(x => x.Value, v => UserName.Create(v).Value)
            .HasMaxLength(100)
            .IsRequired();
    }
}

额外说明 #

• 若想让Email的Value列直接显示为Email而非默认的Email_Value，必须添加HasColumnName("Email")
• EF Core 3.x+版本中OwnsOne已完全替代[ComplexType]特性的功能，无需给Email类添加该特性
• 确保Email类保留无参私有构造函数（你的代码已满足），EF Core需要它来实例化对象

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