EF Core 8 ComplexProperty映射报错：无法转换ComplexType至IReadOnlyEntityType

异常详情 #

在为聚合根Department映射值对象Address作为ComplexProperty时，抛出类型转换异常：

---> System.InvalidCastException: Unable to cast object of type 'Microsoft.EntityFrameworkCore.Metadata.Internal.ComplexType' to type 'Microsoft.EntityFrameworkCore.Metadata.IReadOnlyEntityType'.
   at Microsoft.EntityFrameworkCore.Metadata.Internal.ComplexType.<>c.<get_ConstructorBinding>b__42_0(ComplexType complexType)
   at Microsoft.EntityFrameworkCore.Internal.NonCapturingLazyInitializer.EnsureInitialized[TParam,TValue](TValue& target, TParam param, Action`1 valueFactory)
   at Microsoft.EntityFrameworkCore.Metadata.Internal.ComplexType.get_ConstructorBinding()
   at Microsoft.EntityFrameworkCore.Infrastructure.ModelValidator.<ValidateFieldMapping>g__Validate|24_0(ITypeBase typeBase)
   at Microsoft.EntityFrameworkCore.Infrastructure.ModelValidator.ValidateFieldMapping(IModel model, IDiagnosticsLogger`1 logger)
   at Microsoft.EntityFrameworkCore.Infrastructure.ModelValidator.Validate(IModel model, IDiagnosticsLogger`1 logger)
   at Microsoft.EntityFrameworkCore.Infrastructure.RelationalModelValidator.Validate(IModel model, IDiagnosticsLogger`1 logger)
   at Npgsql.EntityFrameworkCore.PostgreSQL.Infrastructure.Internal.NpgsqlModelValidator.Validate(IModel model, IDiagnosticsLogger`1 logger)
   at Microsoft.EntityFrameworkCore.Infrastructure.ModelRuntimeInitializer.Initialize(IModel model, Boolean designTime, IDiagnosticsLogger`1 validationLogger)
   at Microsoft.EntityFrameworkCore.Internal.DbContextServices.CreateModel(Boolean designTime)
   at Microsoft.EntityFrameworkCore.Internal.DbContextServices.get_Model()
   at Microsoft.EntityFrameworkCore.Infrastructure.EntityFrameworkServicesBuilder.<>c.<TryAddCoreServices>b__8_4(IServiceProvider p)
   ...
   at Microsoft.EntityFrameworkCore.DbContext.Set[TEntity]()
   at Venture.Server.Common.Persistence.EntityEvents.PublishedEntityEventReadRepository.GetConsumedAsync(CancellationToken cancellationToken) in C:\Users\N.Wolf\source\repos\venture-erp\src\Venture.Server.Common\Persistence\EntityEvents\PublishedEntityEventReadRepository.cs:line 25

相关代码 #

聚合根与值对象定义 #

public class Department
{
    public Guid AggregateId { get; protected set; }
    public DateTime Created { get; protected set; }
    public DateTime LastChanged { get; protected set; }
    public Guid EditEmployeeId { get; protected set; }
    public required string Name { get; init; }
    public string? Comment { get; init; }
    public required Address Address { get; init; }

    public Guid DivisionId { get; init; }
    public required Division Division { get; init; }

    public List<Role> EmployeeRoles { get; init; } = [];
    public List<EmployeeDepartmentAssignment> EmployeeAssignments { get; init; } = [];
    public List<DepartmentPosition> Positions { get; init; } = [];

    protected override void ApplyEvent(DepartmentEvent @event)
    {
        throw new NotImplementedException();
    }
}

public record Address
{
    public required string Street { get; init; }
    public required string HouseNumber { get; init; }
    public required string City { get; init; }
    public required string PostalCode { get; init; }
    public required string State { get; init; }
    public required string Country { get; init; }
}

EF Core配置 #

builder.ToTable("access_management_departments");
builder.HasKey(a => a.AggregateId);
builder.Property(a => a.AggregateId).HasColumnName("id").IsRequired();
builder.Property(a => a.Created).HasColumnName("created").IsRequired();
builder.Property(a => a.LastChanged).HasColumnName("last_changed").IsRequired();
builder.Property(a => a.EditEmployeeId).HasColumnName("edit_employee_id").IsRequired();
builder.Property(d => d.Name).HasColumnName("name").HasMaxLength(70).IsRequired();
builder.Property(d => d.Comment).HasColumnName("comment").HasMaxLength(200);
builder.ComplexProperty(d => d.Address, p =>
{
    p.Property(a => a.Street).HasColumnName("address_street").IsRequired();
    p.Property(a => a.HouseNumber).HasColumnName("address_house_number").IsRequired();
    p.Property(a => a.City).HasColumnName("address_city").IsRequired();
    p.Property(a => a.PostalCode).HasColumnName("address_postal_code").IsRequired();
    p.Property(a => a.State).HasColumnName("address_state").IsRequired();
    p.Property(a => a.Country).HasColumnName("address_country").IsRequired();
    p.IsRequired();
});
builder.Property(d => d.DivisionId).HasColumnName("division_id").IsRequired();

builder.Ignore(d => d.Positions);
builder.Ignore(d => d.EmployeeAssignments);
builder.Ignore(d => d.EmployeeRoles);
builder.Ignore(d => d.Division);

问题分析 #

你的配置本身没有明显错误，该异常属于EF Core的已知Bug，主要出现在EF Core 8.x的早期版本中，核心原因是ComplexType的构造函数绑定逻辑错误地尝试将ComplexType实例转换为IReadOnlyEntityType类型，导致类型转换失败。

解决方案 #

1. 升级EF Core版本
   微软在后续补丁版本中修复了该问题，建议直接升级到EF Core 8.0.4及以上的稳定版本，这是最彻底的解决方式。

2. 手动指定构造函数绑定（临时 workaround）
   如果暂时无法升级版本，可以显式为Address类型指定构造函数参数绑定，避免EF Core自动推断出错：

builder.ComplexProperty(d => d.Address, p =>
{
    // 原有属性配置
    p.Property(a => a.Street).HasColumnName("address_street").IsRequired();
    p.Property(a => a.HouseNumber).HasColumnName("address_house_number").IsRequired();
    p.Property(a => a.City).HasColumnName("address_city").IsRequired();
    p.Property(a => a.PostalCode).HasColumnName("address_postal_code").IsRequired();
    p.Property(a => a.State).HasColumnName("address_state").IsRequired();
    p.Property(a => a.Country).HasColumnName("address_country").IsRequired();
    p.IsRequired();

    // 手动指定构造函数
    p.HasConstructor(b => b
        .HasParameter(nameof(Address.Street))
        .HasParameter(nameof(Address.HouseNumber))
        .HasParameter(nameof(Address.City))
        .HasParameter(nameof(Address.PostalCode))
        .HasParameter(nameof(Address.State))
        .HasParameter(nameof(Address.Country)));
});

3. 临时改用Owned Entity
   如果ComplexType的问题无法快速解决，可以暂时将Address配置为Owned Entity（EF Core 2.0及以上版本支持）作为替代方案：

builder.OwnsOne(d => d.Address, p =>
{
    p.Property(a => a.Street).HasColumnName("address_street").IsRequired();
    p.Property(a => a.HouseNumber).HasColumnName("address_house_number").IsRequired();
    p.Property(a => a.City).HasColumnName("address_city").IsRequired();
    p.Property(a => a.PostalCode).HasColumnName("address_postal_code").IsRequired();
    p.Property(a => a.State).HasColumnName("address_state").IsRequired();
    p.Property(a => a.Country).HasColumnName("address_country").IsRequired();
});

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