如何让EF Core忽略实体中的Aggregate包装对象并映射其内部属性

问题场景 #

想要将实体的部分属性用Aggregate类包装，让EF Core忽略Aggregate对象本身，直接将其内部属性视为实体自身的属性。尝试使用[Owned]特性实现，但出现以下错误：

Unable to determine the relationship represented by navigation 'Aggregate.OtherItems' of type 'ICollection<OtherItem>'. Either manually configure the relationship, or ignore this property using the '[NotMapped]' attribute or by using 'EntityTypeBuilder.Ignore' in 'OnModelCreating'.

原有实体代码 #

public class Entity
{
    public Guid Id { get; set; }

    public object SomeProperty { get; set; }
    public ICollection<Item> Items { get; set; }
    public ICollection<OtherItem> OtherItems { get; set; }
}

public class Item
{
    public Entity Entity { get; set; }
    public Guid EntityId { get; set; }
}

public class OtherItem
{
    public Entity Entity { get; set; }
    public Guid EntityId { get; set; }
}

修改后的实体代码 #

public class Entity
{
    public Guid Id { get; set; }

    public Aggregate Aggregate { get; set; } // 希望该对象不被映射，仅映射其内部属性
}

[Owned] // 原本以为符合需求的特性
public class Aggregate
{
    public object SomeProperty { get; set; }
    public ICollection<Item> Items { get; set; }
    public ICollection<OtherItem> OtherItems { get; set; }

    public void SomeUsefulFunction()
    {
        // 业务逻辑实现
    }
}

问题原因 #

EF Core的[Owned]特性用于映射值对象（Value Object），值对象是无标识、依赖主实体的类型，不支持包含集合导航属性。集合导航属于实体间的关联关系，需要依赖实体的主键建立外键映射，而Owned类型没有独立主键，因此无法自动识别这种关联。

解决方案 #

方案1：封装私有属性+Fluent API手动映射 #

将需要映射的属性（包括集合）保留在主实体中（设为私有），通过Aggregate类封装对外暴露，EF直接映射主实体的私有属性，忽略Aggregate对象。

调整实体代码

public class Entity
{
    public Guid Id { get; set; }

    // 私有属性供EF Core映射
    private object _someProperty;
    private readonly ICollection<Item> _items = new List<Item>();
    private readonly ICollection<OtherItem> _otherItems = new List<OtherItem>();

    // 对外暴露Aggregate，封装内部属性
    public Aggregate Aggregate => new Aggregate
    {
        SomeProperty = _someProperty,
        Items = _items,
        OtherItems = _otherItems
    };
}

public class Aggregate
{
    public object SomeProperty { get; set; }
    public ICollection<Item> Items { get; set; }
    public ICollection<OtherItem> OtherItems { get; set; }

    public void SomeUsefulFunction()
    {
        // 执行业务逻辑
    }
}

配置Fluent API

在DbContext的OnModelCreating方法中手动映射私有属性和关联关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Entity>(entity =>
    {
        // 映射标量属性
        entity.Property("_someProperty")
            .HasColumnName("SomeProperty"); // 对应数据库列名

        // 配置Items集合关联
        entity.HasMany("_items")
            .WithOne(i => i.Entity)
            .HasForeignKey(i => i.EntityId)
            .OnDelete(DeleteBehavior.Cascade);

        // 配置OtherItems集合关联
        entity.HasMany("_otherItems")
            .WithOne(oi => oi.Entity)
            .HasForeignKey(oi => oi.EntityId)
            .OnDelete(DeleteBehavior.Cascade);
    });
}

方案2：拆分Aggregate，仅将标量属性设为Owned类型 #

如果业务允许，可以将Aggregate拆分为仅包含标量属性的Owned类型，集合属性直接保留在主实体中：

public class Entity
{
    public Guid Id { get; set; }

    public Aggregate Aggregate { get; set; }
    public ICollection<Item> Items { get; set; }
    public ICollection<OtherItem> OtherItems { get; set; }
}

[Owned]
public class Aggregate
{
    public object SomeProperty { get; set; }

    public void SomeUsefulFunction()
    {
        // 业务逻辑实现
    }
}

这种方式无需额外配置，EF Core会自动将Aggregate的标量属性映射为Entity表的列（列名默认带Aggregate_前缀，比如Aggregate_SomeProperty，可通过Fluent API修改列名）。

内容的提问来源于stack exchange，提问作者R.Haughton