EF Core Cosmos DB按分区键查询返回空数据问题求助

核心问题 #

查询返回空的原因是两个关键配置错误：

1. 属性映射不匹配：实体的Tipo属性未配置映射到JSON中的tipo字段，EF查询时会筛选不存在的Tipo字段，导致无匹配。
2. 类型转换冲突：IdCatalogo属性配置了HasConversion<string>()，但Cosmos DB中存储的idCatalogo是数值类型，EF查询时用字符串值匹配数值，自然无法命中数据。

修复步骤 #

1. 修正实体属性映射配置 #

更新EF Core的实体配置，补全Tipo的JSON映射，并移除IdCatalogo的不必要类型转换：

// 配置Catalog实体属性与JSON字段的映射
modelBuilder.Entity<Model.Catalog>()
    .Property(p => p.IdCatalogo)
    .ToJsonProperty("idCatalogo"); // 移除.HasConversion<string>()，与存储的数值类型匹配

modelBuilder.Entity<Model.Catalog>()
    .Property(p => p.Tipo)
    .ToJsonProperty("tipo"); // 新增：映射到JSON中的小写tipo字段

modelBuilder.Entity<Model.Catalog>()
    .Property(p => p.Activo)
    .ToJsonProperty("activo")
    .HasConversion<int>(); // Activo的转换保留，因为存储的是int类型（1/0对应bool）

2. 保持容器配置正确 #

现有容器配置无需调整，确认分区键指向实体属性IdCatalogo即可：

modelBuilder.Entity<Model.Catalog>().HasNoDiscriminator()
    .ToContainer("Catalogo")
    .HasPartitionKey("IdCatalogo")
    .UseETagConcurrency()
    .HasKey(cat => cat.Id);

3. 编写正确的查询代码 #

使用强类型条件查询，并显式指定分区键（避免跨分区查询，提升性能）：

var queryResults = await _context.Catalogs
    .Where(c => c.IdCatalogo == 6 && c.Tipo == "elemento")
    .WithPartitionKey(6) // 分区键值为int类型，与存储类型一致
    .ToListAsync();

验证 #

修复后，EF生成的查询会正确匹配JSON中的tipo和idCatalogo字段，参数类型与存储类型完全对应，即可返回预期的记录。

内容的提问来源于stack exchange，提问作者Sir Von Jo