未知分区键时，如何通过Azure Cosmos DB ReadItemAsync读取文档？

为什么PartitionKey.None返回404 #

当容器为分区容器时，PartitionKey.None仅用于查找分区键值为null的文档，或无分区键的容器。你的目标文档分区键值为"1234"，不在此范围内，因此返回404。

解决方案 #

1. 获取容器的分区键定义 #

先通过SDK获取容器的分区键路径，明确文档中哪个字段是分区键：

var containerProperties = await container.ReadContainerAsync();
string partitionKeyPath = containerProperties.Resource.PartitionKeyPath;
// 示例返回："/myPartitionKey"，即文档的myPartitionKey字段为分区键

2. 跨分区查询文档（id全局唯一时适用） #

若文档id在容器内全局唯一，可通过查询跨所有分区查找（注意：跨分区查询的RU消耗和延迟高于指定分区键的查询）：

var query = new QueryDefinition("SELECT * FROM c WHERE c.id = @id")
    .WithParameter("@id", id);

using (var resultSetIterator = container.GetItemQueryIterator<Doc>(query))
{
    while (resultSetIterator.HasMoreResults)
    {
        var response = await resultSetIterator.ReadNextAsync();
        var targetDoc = response.FirstOrDefault();
        if (targetDoc != null)
        {
            return targetDoc;
        }
    }
}
return null;

若容器存在同id不同分区的文档，此方法会返回所有匹配结果，需额外筛选。

3. 通过已知字段获取分区键后读取文档 #

若知晓文档的其他唯一标识字段（如邮箱、用户名），可先查询获取分区键值，再调用ReadItemAsync：

// 假设文档有唯一字段email
var query = new QueryDefinition("SELECT c.id, c.myPartitionKey FROM c WHERE c.email = @email")
    .WithParameter("@email", "target@example.com");

using (var resultSetIterator = container.GetItemQueryIterator<dynamic>(query))
{
    if (resultSetIterator.HasMoreResults)
    {
        var response = await resultSetIterator.ReadNextAsync();
        var item = response.FirstOrDefault();
        if (item != null)
        {
            string docId = item.id;
            string partitionKeyValue = item.myPartitionKey;
            var retrievedDoc = await container.ReadItemAsync<Doc>(docId, new PartitionKey(partitionKeyValue));
            return retrievedDoc.Resource;
        }
    }
}

4. 遍历可能的分区键值（仅适用于分区键值范围极小的场景） #

若分区键值的可能范围非常有限（如固定枚举值），可循环尝试每个值，但此方法效率极低、RU消耗大，不建议生产环境使用。

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