Cosmos DB SDK v3分页查询在App Service中报错：分区键组件不足

问题描述 #

基于.NET Framework 4.7.2开发的项目，使用Azure Cosmos DB SDK v3从无分区键配置的容器分页提取实体时，本地运行代码正常，但部署到App Service后执行iterator.ReadNextAsync()时抛出致命异常，错误信息：

PartitionKey has fewer components than defined the collection resource.

相关代码片段：

var results = new List<AutomaticUpgradePlanificationDocument>();

var query = this.Container.GetItemLinqQueryable<AutomaticUpgradePlanificationDocument>(
       continuationToken: continuationToken,
       requestOptions: new QueryRequestOptions() { MaxItemCount = top.GetValueOrDefault(-1), PartitionKey = PartitionKey.None })
   .Where(predicate);

if (orderByExpression != null)
{
    if (isDescending.GetValueOrDefault())
    {
        query = query.OrderByDescending(orderByExpression);
    }
    else
    {
        query = query.OrderBy(orderByExpression);
    }
}

using (var iterator = query.ToFeedIterator())
{
    if (iterator.HasMoreResults)
    {
        var response = await iterator.ReadNextAsync(); // 此处抛出异常（仅App Service环境）
        results.AddRange(response.Resource);

        continuationToken = response.ContinuationToken;
    }
    else
    {
        continuationToken = null;
    }
}

已尝试参考相关问题但解决方案无效。

解决方案 #

1. 移除不必要的PartitionKey配置 #

对于无分区键的容器，不需要指定PartitionKey = PartitionKey.None，SDK会自动识别容器的分区键定义并处理跨分区查询。修改后的请求配置代码：

var query = this.Container.GetItemLinqQueryable<AutomaticUpgradePlanificationDocument>(
       continuationToken: continuationToken,
       requestOptions: new QueryRequestOptions() { MaxItemCount = top.GetValueOrDefault(-1) })
   .Where(predicate);

2. 验证容器元数据一致性 #

检查App Service环境的Cosmos DB连接字符串配置是否与本地一致，避免因配置错误导致SDK获取的容器分区键元数据与实际不符。可在容器初始化时添加日志，确认Container.PartitionKeyPath是否为空。

3. 升级SDK到最新稳定版 #

旧版本SDK在无分区键容器的环境兼容性上存在bug，升级Azure Cosmos DB .NET SDK v3到最新稳定版本，可修复此类跨环境的校验逻辑问题，同时确保与.NET Framework 4.7.2兼容。

备选方案（不推荐） #

若因特殊需求必须指定分区键，可尝试用PartitionKey.FromString("")替代PartitionKey.None，但优先推荐直接移除分区键配置。

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