EF Core 8中如何将复杂类型设为主键及报错解决

错误含义 #

你遇到的错误是因为ContractConfiguration中对ID属性的配置逻辑重复冲突：

• builder.HasKey(x => x.ID)将ID标记为主键
• builder.ComplexProperty(x => x.ID)将ID注册为复杂类型
• 后续builder.Property(x => x.ID).ValueGeneratedNever()又试图把ID当作普通标量属性添加，导致EF Core检测到同名属性重复注册，抛出冲突错误。

解决方案 #

要正确使用复杂类型作为主键，需调整类型定义和配置逻辑：

1. 修正ContractID复杂类型 #

将只读字段改为只读属性，同时添加私有无参构造（满足EF Core实例化需求）：

[ComplexType]
public class ContractID
{
    public short BranchCode { get; }
    public short TypeCode { get; }
    public int CIF { get; }
    public int Counter { get; }

    public ContractID(short branchCode, short typeCode, int cif, int counter)
    {
        BranchCode = branchCode;
        TypeCode = typeCode;
        CIF = cif;
        Counter = counter;
    }

    // EF Core 查询时需要的私有无参构造
    private ContractID() { }
}

2. 修正ContractConfiguration配置类 #

移除重复的Property(x => x.ID)配置，明确指定主键由复杂类型的所有属性组成，并通过ComplexProperty配置细节：

public class ContractConfiguration : IEntityTypeConfiguration<Contract>
{
    public void Configure(EntityTypeBuilder<Contract> builder)
    {
        builder.ToTable("Contracts");        

        // 指定主键由复杂类型的所有属性组合而成
        builder.HasKey(c => new { c.ID.BranchCode, c.ID.TypeCode, c.ID.CIF, c.ID.Counter });
        
        // 注册并配置复杂类型的列
        builder.ComplexProperty(c => c.ID, cp =>
        {
            cp.Property(p => p.BranchCode).HasColumnName("BranchCode").ValueGeneratedNever();
            cp.Property(p => p.TypeCode).HasColumnName("TypeCode").ValueGeneratedNever();
            cp.Property(p => p.CIF).HasColumnName("CIF").ValueGeneratedNever();
            cp.Property(p => p.Counter).HasColumnName("Counter").ValueGeneratedNever();
        });

        builder.Property(x => x.StartDate).HasColumnType("datetime2");
        builder.Property(x => x.EndDate).HasColumnType("datetime2");
    }
}

可行性说明 #

EF Core 8完全支持使用复杂类型作为实体主键，核心要求是：

• 复杂类型必须标记[ComplexType]特性
• 主键需明确指定为复杂类型的所有属性组合（EF会将复杂类型展开为数据库表的多列，而非存储单一标量值）
• 确保复杂类型的属性可被EF Core访问，且提供必要的构造函数支持实例化

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