.NET Entity Framework一对多关系多列导航属性配置报错

场景描述 #

我有两张数据表，Opcr表通过多个外键列关联到ApplicationUser实体表，实体类代码如下：

Opcr实体类 #

[Table("opcr")]
public class Opcr
{
    [Key]
    public int Id { get; set; }
    [Required]
    public string? Title { get; set; }
  
    [Required]
    public string DepartmentHeadId { get; set; }
    [ForeignKey(nameof(DepartmentHeadId))]
    public ApplicationUser DepartmentHead { get; set; }

    [Required]
    public string EvaluatedById { get; set; }
    [ForeignKey(nameof(EvaluatedById))]
    public ApplicationUser EvaluatedBy { get; set; }

    [Required]
    public string ReviewedById { get; set; }
    [ForeignKey(nameof(ReviewedById))]
    public ApplicationUser ReviewedBy { get; set; }
}

ApplicationUser实体类 #

using Microsoft.AspNetCore.Identity;
using System.ComponentModel.DataAnnotations;

namespace LGU_HR.Models;

public class ApplicationUser : IdentityUser
{
    [Required]
    [MaxLength(50)]
    public string? FirstName { get; set; }
    [Required]
    [MaxLength(50)]
    public string? LastName { get; set; }

    // 取消注释后会报错
    // public ICollection<Opcr> DepartmentHead { get; } 
    // public ICollection<Opcr> EvaluatedBy { get; }
    // public ICollection<Opcr>? ReviewedBy { get; }
}

我想建立一对多关联，实现通过用户查询Opcr数据，但取消注释ApplicationUser中的导航属性后，出现错误：

Unable to create a 'DbContext' of type ''. The exception 'Unable to determine the relationship represented by navigation 'ApplicationUser.DepartmentHead' of type 'ICollection'. Either manually configure the relationship, or ignore this property using the '[NotMapped]' attribute or by using 'EntityTypeBuilder.Ignore' in 'OnModelCreating'.' was thrown while attempting to create an instance. For the different patterns supported at design time

请问错误原因是什么？我哪里操作错了？

错误原因 #

EF Core无法自动识别多个同类型导航属性对应的关系：你在ApplicationUser里定义的DepartmentHead、EvaluatedBy、ReviewedBy集合属性，和Opcr里同名的导航属性完全重复，EF Core没办法自动匹配到对应的外键关联规则，导致无法确定每个关系的对应逻辑。

解决方法 #

必须显式配置每个关系，告诉EF Core每个导航属性对应的反向导航和外键，有两种实现方式：

方式1：使用数据注解（[InverseProperty]） #

修改ApplicationUser的导航属性，用[InverseProperty]明确指定对应的Opcr中的导航属性，同时建议给集合属性起清晰的名称避免重名：

public class ApplicationUser : IdentityUser
{
    [Required]
    [MaxLength(50)]
    public string? FirstName { get; set; }
    [Required]
    [MaxLength(50)]
    public string? LastName { get; set; }

    // 指定对应Opcr中的DepartmentHead导航属性
    [InverseProperty(nameof(Opcr.DepartmentHead))]
    public ICollection<Opcr> DepartmentHeadOpcrs { get; } = new List<Opcr>();

    // 指定对应Opcr中的EvaluatedBy导航属性
    [InverseProperty(nameof(Opcr.EvaluatedBy))]
    public ICollection<Opcr> EvaluatedByOpcrs { get; } = new List<Opcr>();

    // 指定对应Opcr中的ReviewedBy导航属性
    [InverseProperty(nameof(Opcr.ReviewedBy))]
    public ICollection<Opcr> ReviewedByOpcrs { get; } = new List<Opcr>();
}

方式2：使用Fluent API（DbContext中配置） #

如果不想用数据注解，可在DbContext的OnModelCreating方法中手动配置每个关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder); // 必须保留，IdentityUser需要基础配置

    // 配置DepartmentHead关联
    modelBuilder.Entity<Opcr>()
        .HasOne(o => o.DepartmentHead)
        .WithMany(u => u.DepartmentHeadOpcrs) // 对应ApplicationUser里的集合属性
        .HasForeignKey(o => o.DepartmentHeadId)
        .OnDelete(DeleteBehavior.Restrict); // 根据业务需求设置删除行为

    // 配置EvaluatedBy关联
    modelBuilder.Entity<Opcr>()
        .HasOne(o => o.EvaluatedBy)
        .WithMany(u => u.EvaluatedByOpcrs)
        .HasForeignKey(o => o.EvaluatedById)
        .OnDelete(DeleteBehavior.Restrict);

    // 配置ReviewedBy关联
    modelBuilder.Entity<Opcr>()
        .HasOne(o => o.ReviewedBy)
        .WithMany(u => u.ReviewedByOpcrs)
        .HasForeignKey(o => o.ReviewedById)
        .OnDelete(DeleteBehavior.Restrict);
}

同时ApplicationUser里的集合属性要对应配置：

public class ApplicationUser : IdentityUser
{
    // ... 其他属性

    public ICollection<Opcr> DepartmentHeadOpcrs { get; } = new List<Opcr>();
    public ICollection<Opcr> EvaluatedByOpcrs { get; } = new List<Opcr>();
    public ICollection<Opcr> ReviewedByOpcrs { get; } = new List<Opcr>();
}

关键注意点 #

• 当一个实体和另一个实体存在多个一对多关系时，EF Core无法自动推断每个导航属性的关联逻辑，必须显式指定反向导航或外键。
• 尽量给集合属性起清晰的名称，避免和反向导航属性重名，减少混淆。

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