使用CosmosDB分页查询时为何总是得到相同的continueToken？

你在使用CosmosDB的continueToken分页时遇到了问题，代码逻辑如下：

continueToken = null;

using var feedIterator = linqQueryable.ToFeedIterator();
while (feedIterator.HasMoreResults)
{
    var response = await feedIterator.ReadNextAsync();
    results.AddRange(response);

    if (results.Count >= pageSize)
    {
        continueToken = response.ContinuationToken;
        break;
    }
}            

但总是得到相同的continueToken，查询结果重复；添加排序键后分页功能恢复正常。以下是针对问题的解答：

核心结论 #

不是必须添加排序键，但强烈建议添加，否则极易出现分页重复、continueToken无效的问题。

问题根源 #

当查询未指定排序键时，CosmosDB会按照数据的物理存储顺序返回结果，而物理存储顺序是不稳定的：

• 数据插入、更新或删除操作，可能改变数据的物理存储位置；
• 缺乏稳定的排序依据时，continueToken无法准确定位下一页的起始偏移量，导致每次分页查询都从近似相同的位置获取数据，结果重复，生成的continueToken也会一致。

排序键解决问题的原理 #

排序键提供了稳定、可预测的结果顺序，continueToken会基于排序后的字段值生成，确保每次分页都能准确推进到下一组数据，不会重复获取已有结果。建议选择唯一且不频繁变更的字段作为排序键（比如文档的id，或业务唯一标识字段），复杂场景下也可使用复合排序键。

替代方案的局限性 #

如果确实无法使用排序键，需确保查询有唯一且稳定的筛选条件约束结果范围，但这种方式仍存在风险——物理存储顺序的不确定性还是可能导致分页异常，因此添加排序键是最稳妥的解决方案。

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