EF Core：值对象与父实体组合唯一索引配置问题

原始实体定义 #

public sealed class ExternalSystem : Entity
{
    public ExternalSystemName Name { get; private set; }

    public Deployment Deployment { get; private set; }
}

需求：基于Deployment的ID和ExternalSystemName.Value配置组合唯一索引，确保同一部署下不存在同名外部系统。

初始配置与异常 #

尝试通过IEntityTypeConfiguration配置索引：

internal sealed class ExternalSystemsConfiguration : 
IEntityTypeConfiguration<ExternalSystem>
{
    public void Configure(EntityTypeBuilder<ExternalSystem> builder)
    {
        builder.ToTable("TblExternalSystems");

        builder.OwnsOne(e => e.Name, navigationBuilder =>
        {
            navigationBuilder.Property(e => e.Value)
            .HasColumnName("Name");
        });

        builder.HasIndex(e => new { e.Name, e.Deployment }).IsUnique();
    }
}

触发第一个异常：

System.InvalidOperationException: ''Name' cannot be used as a property on entity type 'ExternalSystem' because it is configured as a navigation.'

修改为引用e.Name.Value后，出现第二个异常：

System.ArgumentException: 'The expression 'e => new <>f__AnonymousType0`2(Value = e.Name.Value, Deployment = e.Deployment)' is not a valid member access expression. The expression should represent a simple property or field access: 't => t.MyProperty'. When specifying multiple properties or fields, use an anonymous type: 't => new { t.MyProperty, t.MyField }'. (Parameter 'memberAccessExpression')'

后续尝试与新问题 #

添加DeploymentId基元属性后，成功配置单字段索引；但给值对象添加对应基元属性时：

public sealed class ExternalSystem : Entity
{
    public ExternalSystemName NameV { get; private set; }

    public string Name { get; private set; }

    public Deployment Deployment { get; private set; }

    public Guid DeploymentId { get; private set; }
}

EF Core生成重复列Name和ExternalSystem_Name，导致业务异常。

原因分析 #

1. 关联实体的DeploymentId可通过EF Core外键自动关联机制，与Deployment导航属性绑定，不会重复生成列；但值对象是通过OwnsOne配置的嵌套对象，默认会为其属性生成独立列。
2. 手动添加Name基元属性后，EF Core既会为值对象NameV的Value属性生成默认列（如ExternalSystem_Name），又会为手动添加的Name属性生成一列，最终导致重复。

解决方法 #

无需手动添加值对象对应的基元属性，直接针对值对象的嵌套属性配置索引即可，正确配置代码如下：

internal sealed class ExternalSystemsConfiguration : 
IEntityTypeConfiguration<ExternalSystem>
{
    public void Configure(EntityTypeBuilder<ExternalSystem> builder)
    {
        builder.ToTable("TblExternalSystems");

        // 配置值对象映射到数据库列
        builder.OwnsOne(e => e.Name, navigationBuilder =>
        {
            navigationBuilder.Property(e => e.Value)
                .HasColumnName("Name")
                .IsRequired();
        });

        // 配置组合唯一索引：值对象Value属性 + 关联实体ID属性
        builder.HasIndex(e => new { e.Name.Value, e.DeploymentId }).IsUnique();

        // 显式关联导航属性与外键（若EF未自动识别）
        builder.HasOne(e => e.Deployment)
            .WithMany() // 根据实际关联关系调整，比如Deployment是否包含ExternalSystem集合
            .HasForeignKey(e => e.DeploymentId);
    }
}

低版本EF Core兼容写法 #

若使用EF Core 3.0以下版本，无法直接在索引中引用嵌套属性，可通过指定列名配置：

builder.HasIndex("Name", "DeploymentId").IsUnique();

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