Cosmos DB复合分区键查询报错：分区键组件数量不匹配怎么解决

错误原因 #

你直接将复合分区键的JSON字符串作为单个参数传入PartitionKey构造函数，Cosmos DB会将其识别为一个分区键组件，但你的容器配置的是包含两个组件的复合分区键，因此出现组件数量不匹配的报错。

正确解决方案 #

方案1：使用多组件构造函数（推荐） #

直接传递每个分区键组件的原始值，PartitionKey构造函数会自动处理复合结构：

List<(string, PartitionKey)> itemsToFind = new();
// 传入两个分区键组件值，构造复合PartitionKey
itemsToFind.Add(("testApi", new PartitionKey("value1", "value2")));
var result = await container.ReadManyItemsAsync<MyClass>(items: itemsToFind);

方案2：从JSON字符串解析复合分区键 #

如果必须通过JSON字符串传递复合分区键值，使用PartitionKey.FromJsonString方法解析，它会正确识别JSON数组中的多个组件：

List<(string, PartitionKey)> itemsToFind = new();
var partitionKeyJson = "[\"value1\", \"value2\"]";
itemsToFind.Add(("testApi", PartitionKey.FromJsonString(partitionKeyJson)));
var result = await container.ReadManyItemsAsync<MyClass>(items: itemsToFind);

注意：不要使用new PartitionKey(jsonString)的方式，该构造函数会将整个字符串视为单一分区键值，无法解析为复合组件结构。

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