EF Core 6 Cosmos提供程序拥有类型Id属性被映射为父实体分区键问题

问题成因 #

EF Core 6的Cosmos提供程序对名为Id的属性存在默认特殊关联逻辑：Cosmos容器的分区键默认绑定主实体的Id属性，当拥有类型（Owned Type）中也定义了Id属性时，EF Core会错误地将拥有类型的Id识别为主实体的分区键字段，而非嵌套属性。这导致生成查询SQL时，遗漏了拥有类型Id的嵌套路径过滤，最终出现查询逻辑错误。

修复方法 #

方法1：显式配置拥有类型Id的属性映射 #

通过ModelBuilder明确指定拥有类型Id对应的Cosmos文档嵌套字段名，避免与主实体分区键混淆：

modelBuilder.Entity<Order>().OwnsOne(x => x.OrderAddress, addressBuilder =>
{
    // 将Address的Id属性映射为文档中的"AddressId"字段
    addressBuilder.Property(a => a.Id).ToJsonProperty("AddressId");
});

配置后，EF会正确识别该属性为拥有类型的嵌套字段，生成符合预期的过滤条件。

方法2：修改拥有类型的属性名称 #

直接将Address的Id属性改名为非Id的名称（比如AddressId、Xyz），这样EF不会触发默认的分区键关联逻辑，自然生成正确的查询语句。

方法3：显式声明主实体的分区键 #

通过显式配置主实体的分区键，强化EF对主实体Id的识别，避免与拥有类型的Id混淆：

modelBuilder.Entity<Order>()
    .HasPartitionKey(o => o.Id) // 明确指定主实体分区键
    .OwnsOne(x => x.OrderAddress);

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