Entity Framework中如何将外键关联到实体的唯一键？

你的问题核心是EF默认会将外键关联到主实体的主键，但你的外键类型和主键不匹配，且需要关联主实体上的唯一键（备用键），以下是两种可行的解决方式：

方式一：使用Fluent API配置（推荐，更灵活清晰） #

在DbContext的OnModelCreating方法中显式配置关联关系，指定外键对应的主实体唯一键：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 将Location的唯一键标记为备用键
    modelBuilder.Entity<Location>()
        .HasAlternateKey(l => l.LocationCode); // LocationCode为你要关联的唯一键字段

    // 配置SummarizedPart与Location的关联
    modelBuilder.Entity<SummarizedPart>()
        .HasOne(sp => sp.LocationNavigation) // 引用类的导航属性
        .WithMany(l => l.Parts) // 主实体的集合导航属性
        .HasForeignKey(sp => sp.LocationRef) // 引用类的外键字段
        .HasPrincipalKey(l => l.LocationCode); // 指定关联主实体的唯一键（备用键）
}

方式二：使用DataAnnotations注解（EF Core 5及以上版本支持） #

直接在实体类上通过注解标记备用键和关联关系：

主实体（Location）类： #

public class Location
{
    public Guid LId { get; set; } // 主键
    [AlternateKey] // 标记该字段为备用键（唯一键）
    public string LocationCode { get; set; }
    public ICollection<SummarizedPart> Parts { get; set; }
}

引用类（SummarizedPart）类： #

public class SummarizedPart
{
    public int Id { get; set; }
    public string LocationRef { get; set; }

    [ForeignKey(nameof(LocationRef))]
    [PrincipalKey(nameof(Location.LocationCode))] // 指定关联主实体的备用键
    public Location LocationNavigation { get; set; }
}

报错原因说明 #

之前仅使用[ForeignKey]注解时，EF会默认尝试将外键关联到主实体的主键（LId，Guid类型），但你的外键LocationRef是string类型，类型不匹配导致抛出InvalidOperationException。通过上述配置指定关联主实体的唯一键（备用键）后，类型匹配，关系即可正常建立。

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