使用CosmosDB FeedIterator是否会产生多个continuation token？

你当前的全量循环拉取写法存在逻辑偏差，关于多批次响应中Continuation Token的有效性，规则非常明确：

• 每个FeedResponse<T>携带的ContinuationToken，仅对应当前批次结果完整消费后的续查起始位置，只要你已经完整拿到了该批次及之前所有批次的结果，这个token就是有效的，不存在“后续新token生成后旧token立刻失效”的情况。
• 如果你按照示例里的while循环把所有结果全部拉取完成，最后一次ReadNextAsync()返回的ContinuationToken一定是null——这个值代表查询已经遍历完所有匹配结果，没有剩余数据可以续查，把这个null值返回给调用方没有实际业务意义。
• 如果你要实现分页返回（也就是单次接口请求只返回部分结果，支持调用方拿着token翻下一页），绝对不能用while循环拉完所有FeedResponse：你只需要在单次请求里调用一次ReadNextAsync()拉取单批结果，把这批结果返回给调用方的同时，直接返回当前批次对应的ContinuationToken即可，这个token就是和当前返回结果完全匹配的有效续查凭证。

正确的分页查询实现参考 #

// 入参continuationToken由调用方传入，首次查询传null即可
FeedIterator<T> feedIterator = container.GetItemQueryIterator<T>(
    queryDefinition, 
    requestContinuationToken: continuationToken, 
    requestOptions: queryOptions);

var myResponse = new MyResponse();
// 仅拉取单批结果，不做全量循环
if (feedIterator.HasMoreResults)
{
    FeedResponse<T> response = await feedIterator.ReadNextAsync();
    myResponse.ContinuationToken = response.ContinuationToken;
    myResponse.Objects = response.ToList();
}

特殊场景注意事项 #

如果你确实需要在服务端聚合多批结果后再返回（比如服务端做跨批次的数据过滤、加工），请在每成功读取一个FeedResponse、把该批次结果加入待返回列表后，立刻更新当前记录的ContinuationToken：

• 一旦循环过程中出现请求超时、服务异常，你最后记录的token就是已经成功消费的准确位置，下次重试不会出现重复读、漏读的问题
• 不要等所有循环执行完成再取token，否则如果中途报错，你没有任何有效位置标记可以用来恢复查询
• 当循环正常退出、所有匹配结果都拉取完成时，最终拿到的token一定是null，此时可以告知调用方查询已完成

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