Entity Framework插入Cosmos DB时嵌套对象被存为独立文档如何处理

问题原因 #

• 你同时为Author和Book都配置了DbSet，EF Core Cosmos 提供程序默认会将每个关联了DbSet的实体识别为独立的根文档实体，即使存在导航属性，也会存储为独立文档。
• 未显式配置实体间的从属关系，EF Core 默认会将两个实体的关联识别为独立实体的引用关系，而非嵌套包含关系。

调整方案 #

步骤1：移除不必要的DbSet配置 #

如果Book不需要作为独立根文档查询存储，直接删除BookStoreDbContext中Book对应的DbSet定义：

// 删掉这一行
public DbSet<Book> Books { get; set; }

步骤2：显式配置从属实体关系 #

重写BookStoreDbContext的OnModelCreating方法，通过OwnsMany方法配置Book是Author的从属集合，需要嵌套存储：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Author>()
        .OwnsMany(a => a.Books, b =>
        {
            b.WithOwner();
        });
    // 如果Book类里保留了Author导航属性，需要配置忽略避免循环引用
    modelBuilder.Entity<Book>()
        .Ignore(b => b.Author);
}

步骤3：可选调整实体类 #

可以直接删除Book类中的Author导航属性，避免不必要的循环引用风险：

public class Book
{
    public Guid BookId { get; set; }
    public string Title { get; set; }
    // 删掉Author导航属性
    // public Author Author { get; set; }
}

调整完成后重新执行插入代码，Book对象就会作为嵌套数组直接存储在Author的同一文档内，符合预期。

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