EF Core如何确定要使用的实体参数化构造函数？

问题 #

我使用了EF Core 7.0的参数化构造函数实体特性，但对EF Core选择构造函数的行为有疑问。我定义了Poll实体，Id是只读属性，因此写了两个构造函数：一个用于创建实体（自动生成Id），一个用于重构（接收Id参数）：

public class Poll
{
    public Guid Id { get; }
    public string Name {get;set;}
    public DateTime ExpirationDate { get; set; }
    public List<Vote> Votes { get; set; }
    public List<DateTime> dates {get;set;} = new List<DateTime>();

    public Poll(string name, List<DateTime> dates) : this(
        Guid.NewGuid(), 
        name,
        new List<Vote>(), 
        dates, 
        DateTime.UtcNow.AddMonths(2)
        )
    {
    }

    public Poll(Guid id, string name, List<DateTime> dates, DateTime expirationDate)
    {
        Name = name;
        Id = id;
        Dates = dates;
        ExpirationDate = expirationDate;
    }
}

对应的模型配置代码：

modelBuilder.Entity<Poll>(entity =>
{
    entity.HasKey(poll => poll.Id);
    entity
        .Property(poll => poll.Id)
        .ValueGeneratedNever();
    entity.Property(poll => poll.Name);
    entity.Property(poll => poll.Dates);
    entity.Property(poll => poll.ExpirationDate);
});

查询实体时，EF Core调用的是第一个构造函数，但根据文档描述“如果EF Core找到参数名称和类型与映射属性匹配的参数化构造函数，则会调用该构造函数并传入对应属性值”，我预期它应该使用第二个构造函数。

补充：移除第一个构造函数时，会抛出“votes参数无法绑定到属性”的异常；移除Votes相关内容后可正常工作，但重新添加第一个构造函数后，EF Core还是优先使用它。

解答 #

1. EF Core构造函数选择的核心逻辑 #

EF Core选择构造函数时，并非单纯匹配“所有映射属性”，而是遵循参数数量更少但能覆盖必要绑定需求的优先规则，同时优先选择public可访问性的构造函数。你的第一个构造函数参数更少，且通过this调用链给Votes导航属性赋了默认值，满足了EF Core对所有映射属性/导航属性的绑定要求，因此被优先选中。

另外，第二个构造函数缺少Votes参数，EF Core无法通过它完成所有映射成员的绑定，这也是它未被优先选择的关键原因——当移除第一个构造函数时，EF Core找不到能覆盖所有绑定需求的构造函数，就会抛出“votes参数无法绑定”的异常。

2. 可行的解决方法 #

方法一：显式指定EF Core使用的构造函数

在模型配置中通过HasConstructor强制指定目标构造函数，直接跳过自动选择逻辑：

modelBuilder.Entity<Poll>(entity =>
{
    entity.HasKey(poll => poll.Id);
    entity.Property(poll => poll.Id).ValueGeneratedNever();
    entity.Property(poll => poll.Name);
    entity.Property(poll => poll.Dates);
    entity.Property(poll => poll.ExpirationDate);
    
    // 指定使用带Id、name、dates、expirationDate参数的构造函数
    entity.HasConstructor(typeof(Guid), typeof(string), typeof(List<DateTime>), typeof(DateTime));
});

方法二：补全目标构造函数的绑定参数

给第二个构造函数添加Votes参数（可设默认值），让它能覆盖所有映射成员的绑定需求，这样EF Core会优先选择这个更完整的构造函数：

public Poll(Guid id, string name, List<DateTime> dates, DateTime expirationDate, List<Vote> votes = null)
{
    Name = name;
    Id = id;
    Dates = dates;
    ExpirationDate = expirationDate;
    Votes = votes ?? new List<Vote>();
}

方法三：调整创建构造函数的访问级别

将第一个用于创建实体的构造函数改为internal或private，EF Core会优先选择public的第二个构造函数（前提是第二个构造函数能满足绑定需求）：

internal Poll(string name, List<DateTime> dates) : this(
    Guid.NewGuid(), 
    name,
    new List<Vote>(), 
    dates, 
    DateTime.UtcNow.AddMonths(2)
    )
{
}

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