.NET7 Clean Architecture下Agency实体构造函数匹配错误求助

使用ardalis/clean-architecture模板开发.NET7应用，完成模型建模后执行数据库迁移，持续报错：

No suitable constructor was found for entity type 'Agency'. The following constructors had parameters that could not be bound to properties of the entity type:
Cannot bind 'team' in 'Agency(string name, string email, string phoneNumber, CompanySettings billingInfo, TaxInformation taxInformation, AgencyTeam team)'
Cannot bind 'shippingInfo', 'team' in 'Agency(string name, string email, string phoneNumber, CompanySettings billingInfo, CompanySettings shippingInfo, TaxInformation taxInformation, AgencyTeam team)'

相关模型代码 #

Agency.cs

public class Agency : Company, IAggregateRoot
{
    public AgencyTeam Team { get; private set; }

    public Agency(
        string name,
        string email,
        string phoneNumber,
        CompanySettings billingInfo,
        TaxInformation taxInformation,
        AgencyTeam team
    )
        : base(name, email, phoneNumber, billingInfo, taxInformation)
    {
        Team = Guard.Against.Null(team, nameof(team));
    }

    public Agency(
        string name,
        string email,
        string phoneNumber,
        CompanySettings billingInfo,
        CompanySettings shippingInfo,
        TaxInformation taxInformation,
        AgencyTeam team
    )
        : base(name, email, phoneNumber, billingInfo, shippingInfo, taxInformation)
    {
        Team = Guard.Against.Null(team, nameof(team));
    }
}

Company.cs（Agency的基类）

public class Company : EntityBase, IAggregateRoot
{

  public string Name { get; private set; }

  public string Email { get; private set; }

  public string PhoneNumber { get; private set; }

  public CompanySettings BillingInfo { get; private set; }

  public CompanySettings ShippingInfo { get; private set; }

  public TaxInformation TaxInformation { get; private set; }

  public DateTime CreatedAt { get; private set; }

  public Company(string name, string email, string phoneNumber, CompanySettings billingInfo, CompanySettings shippingInfo, TaxInformation taxInformation)
  {
    Name = Guard.Against.NullOrEmpty(name, nameof(name));
    Email = Guard.Against.NullOrEmpty(email, nameof(email));
    PhoneNumber = Guard.Against.NullOrEmpty(phoneNumber, nameof(phoneNumber));
    BillingInfo = Guard.Against.Null(billingInfo, nameof(billingInfo));
    ShippingInfo = Guard.Against.Null(shippingInfo, nameof(shippingInfo));
    TaxInformation = Guard.Against.Null(taxInformation, nameof(taxInformation));
    CreatedAt = DateTime.Now;
  }

  public Company(string name, string email, string phoneNumber, CompanySettings billingInfo, TaxInformation taxInformation)
  {
    Name = Guard.Against.NullOrEmpty(name, nameof(name));
    Email = Guard.Against.NullOrEmpty(email, nameof(email));
    PhoneNumber = Guard.Against.NullOrEmpty(phoneNumber, nameof(phoneNumber));
    BillingInfo = Guard.Against.Null(billingInfo, nameof(billingInfo));
    ShippingInfo = BillingInfo;
    TaxInformation = Guard.Against.Null(taxInformation, nameof(taxInformation));
    CreatedAt = DateTime.Now;
  }
}

AgencyTeam.cs

public class AgencyTeam : EntityBase
{
    public AgencyTeam() { }
}

AgencyUser.cs

public class AgencyUser : ApplicationUser
{
    public AgencyTeam Team { get; private set; }

    private List<Contact> _assignedContacts = new List<Contact>();

    [PersonalData]
    public IEnumerable<Contact> AssignedContacts => _assignedContacts.AsReadOnly();

    private List<ProjectAggregate.Task> _assignedTasks = new List<ProjectAggregate.Task>();

    [PersonalData]
    public IEnumerable<ProjectAggregate.Task> AssignedTasks => _assignedTasks.AsReadOnly();

    public AgencyUser(string firstName, string lastName, string jobTitle, AgencyTeam team)
        : base(firstName, lastName, jobTitle)
    {
        Team = Guard.Against.Null(team, nameof(team));
    }
}

CompanySettings.cs

public class CompanySettings : EntityBase
{
  public string Email { get; private set; }

  public Address Address { get; private set; }

  public CompanySettings(string email, Address address)
  {
    Email = Guard.Against.NullOrEmpty(email, nameof(email));
    Address = Guard.Against.Null(address, nameof(address));
  }
}

解决方案 #

这个错误的核心原因是EF Core无法自动识别AgencyTeam作为Agency的导航属性完成构造函数参数绑定，同时基类Company的构造函数参数存在映射歧义。以下是三种可行的解决方式：

方案1：添加私有无参数构造函数（最简便的兼容方案）

EF Core需要无参数构造函数来实例化实体，私有构造函数不会破坏领域模型的封装性，仅供EF Core内部使用：

// 在Agency类中添加
public class Agency : Company, IAggregateRoot
{
    public AgencyTeam Team { get; private set; }

    // 私有无参构造函数
    private Agency() : base() { }

    // 保留原有业务构造函数
    public Agency(...) { ... }
}

// 在Company类中添加
public class Company : EntityBase, IAggregateRoot
{
    // 私有无参构造函数
    private Company() { }

    // 保留原有属性和业务构造函数
}

方案2：显式配置EF Core构造函数绑定

如果不想添加无参构造函数，可以在DbContext的OnModelCreating方法中指定构造函数并映射参数：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    modelBuilder.Entity<Agency>(entity =>
    {
        // 指定使用第一个业务构造函数，映射参数到对应属性/导航属性
        entity.HasConstructor(
            typeof(string), typeof(string), typeof(string),
            typeof(CompanySettings), typeof(TaxInformation), typeof(AgencyTeam))
        .Parameter(nameof(name), e => e.Name)
        .Parameter(nameof(email), e => e.Email)
        .Parameter(nameof(phoneNumber), e => e.PhoneNumber)
        .Parameter(nameof(billingInfo), e => e.BillingInfo)
        .Parameter(nameof(taxInformation), e => e.TaxInformation)
        .Parameter(nameof(team), e => e.Team);
    });
}

方案3：显式配置导航属性关系

确保EF Core明确识别Agency与AgencyTeam的关联关系，在DbContext中添加配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    modelBuilder.Entity<Agency>()
        .HasOne(a => a.Team)
        .WithMany() // 若AgencyTeam无反向导航属性则使用此写法
        .IsRequired(); // 根据业务需求设置是否必填
}

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