EF Core 3.1如何在不暴露集合时加载拥有实体的嵌套属性

问题背景 #

你已经通过EF Core的OwnedMany配置了聚合根Order和其私有集合_orderProducts的关联，并且知道拥有类型默认会被自动加载，但现在需要在加载Order时同时加载每个OrderProduct关联的Product，同时希望保持_orderProducts的私有性，不对外暴露可修改的集合。

解决方案 #

针对你的需求，有两种可行的实现方式，都能满足不暴露私有集合的要求：

1. 使用字符串路径进行嵌套Include（无需修改实体类）

EF Core支持通过导航属性的字符串路径来进行Include操作，即使对应的导航字段是私有的。你可以直接在查询中指定_orderProducts.Product路径，EF Core会识别到这个私有字段对应的导航关系：

public async Task<App.Domain.Orders.Order> GetOrder(Guid orderId) 
{ 
    return await _appDbContext.Orders
        .Include("_orderProducts.Product")
        .SingleOrDefaultAsync(x => x.OrderId == orderId); 
}

这种方式不需要修改Order类的任何代码，完全保留了_orderProducts的私有性，缺点是字符串路径没有编译时类型检查，容易写错字段名称。

2. 暴露只读的公共导航属性（更类型安全）

如果你希望使用类型安全的lambda语法，同时又不想暴露可修改的集合，可以在Order类中添加一个只读的IEnumerable<OrderProduct>属性，它只返回私有集合的只读视图：

public class Order : IAggregateRoot { 
    public Guid OrderId { get; private set; } 
    public string Title { get; private set; } 
    private ICollection<OrderProduct> _orderProducts; 
    // 新增只读属性，对外暴露不可修改的集合视图
    public IEnumerable<OrderProduct> OrderProducts => _orderProducts.AsReadOnly();
    private Order() { _orderProducts = new List<OrderProduct>(); } 
}

之后就可以用lambda语法进行嵌套Include，既保证了类型安全，又不会让外部代码修改内部集合：

public async Task<App.Domain.Orders.Order> GetOrder(Guid orderId) 
{ 
    return await _appDbContext.Orders
        .Include(x => x.OrderProducts)
            .ThenInclude(op => op.Product)
        .SingleOrDefaultAsync(x => x.OrderId == orderId); 
}

这种方式符合DDD的封装原则：外部只能读取集合内容，无法直接修改，所有集合的变更都必须通过Order聚合根的方法来完成。

关键原理说明 #

• 拥有类型（OrderProduct）默认被自动加载，但它关联的Product是独立实体，不属于拥有类型的一部分，所以EF Core不会自动加载，必须显式通过Include/ThenInclude指定。
• EF Core在处理导航属性时，无论是公共属性还是私有字段，只要在EntityTypeConfiguration中正确配置了关联关系，都可以通过查询进行加载，字符串路径方式就是直接映射到私有字段的名称。

内容的提问来源于stack exchange，提问作者j.arap