Azure Cosmos DB中ReadManyItemsAsync为何执行Query而非读取操作？

根据微软文档，ReadManyItemsAsync应执行低成本的单条查找操作，每条条目RU费用为1，但传入单个id/PartitionKey时，实际执行Query操作（产生2.95RU费用），以下是可能的原因：

可能的原因 #

• SDK版本问题
  早期.NET SDK版本对单条目ReadMany的处理逻辑未做优化，当仅传入一组id+PartitionKey时，会 fallback 到Query路径。建议升级到最新稳定版SDK（至少3.30+版本），该版本针对单条目场景做了优化，会触发单条读取逻辑。

• PartitionKey类型不匹配
  确保代码中构造的PartitionKey值与文档实际存储的分区键类型完全一致。例如文档分区键是数字类型，但代码传入字符串形式的PartitionKey，SDK无法精准匹配，会退化为Query操作。可通过Cosmos DB数据资源管理器查看目标文档的分区键原始类型，保证类型匹配。

• 容器索引策略异常
  若容器修改过索引策略（如禁用了id或分区键的索引），ReadMany无法通过索引快速定位文档，会转为Query。检查容器索引策略，确保id和分区键路径的索引处于启用状态（默认策略已启用）。

• 单条目场景的SDK行为
  部分SDK版本中，当ReadManyItemsAsync仅传入一个条目时，内部未触发批量读取优化逻辑，而是执行Query。这种情况下，可在条目数为1时直接调用ReadItemAsync，对比RU消耗。

你的实现代码 #

if (ids.Count != partitionKeys.Count)
    throw new ArgumentOutOfRangeException("ids and partitionKey counts must match"); 

var container = Database.GetContainer(containerId); 
List<(string, PartitionKey)> itemsToFind = new(); 
for (int i = 0; i < ids.Count(); i++)
{
    itemsToFind.Add((ids[i],new PartitionKey(partitionKeys[i])));
}

var result  = await container.ReadManyItemsAsync<T>(items: itemsToFind);
return result; 

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