Azure Cosmos DB+EF Core：无法在拥有型属性中使用嵌入式集合？

问题原因 #

这确实是Azure Cosmos DB的EF Core提供程序的限制：拥有型实体（Owned Entity）不能通过HasMany配置集合关系。因为Cosmos DB是文档型数据库，EF Core对Cosmos的适配逻辑中，拥有实体是作为父文档的嵌入式内容存在，而非关系型数据库中的独立表/实体。HasMany是为关系型数据库的外键关联设计的，强行对拥有实体使用该配置会导致EF Core内部逻辑出错，出现空引用异常。

未配置时的报错，是因为EF Core无法自动识别Cosmos文档中嵌入集合的处理方式，默认会将集合视为关系型关联，因此要求手动配置或忽略属性。

正确配置方式 #

需要在父实体的OwnsOne配置中，通过链式调用OwnsMany来配置嵌套的集合，将其声明为嵌入式拥有集合，而非独立实体关联：

modelBuilder.Entity<Root>()
    .OwnsOne(x => x.Child, childBuilder => 
    {
        // 配置Child中的GrandChildren为嵌入式拥有集合
        childBuilder.OwnsMany(c => c.GrandChildren);
    });

额外注意事项 #

为避免运行时空引用，建议在模型初始化时为集合属性赋值：

class Child 
{
   public List<GrandChild> GrandChildren { get; set; } = new List<GrandChild>();
}

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