使用MS Graph API分页获取Teams聊天时遇空页问题及优化咨询

我正在使用C#中的GraphServiceClient获取Teams聊天，初始请求代码如下：

var chats = await graphClient.Chats
                            .GetAsync(requestConfiguration =>
                            {
                                requestConfiguration.QueryParameters.Filter = "chatType eq 'group' and topic ne null and viewpoint/isHidden eq false";
                            });

之后用以下代码分页获取所有聊天并合并到chatsAll变量中：

while (true)
{
    foreach (var chat in chats.Value)
    {
        chatsAll.Add(chat);
    }

    if (!string.IsNullOrEmpty(chats.OdataNextLink))
    {
        chats = await graphClient.Chats
            .WithUrl(chats.OdataNextLink).GetAsync();
    }
    else
    {
        break;
    }
}

遇到的问题：部分请求返回的chats.Value无记录，但ODataNextLink不为空。如果加if(chats.Value == null || chats.Value.Count == 0) break;作为终止条件，又可能漏掉后续页面的有效结果。

请问：

1. 分页查询里为啥会出现空页？
2. 怎么在聚合符合Filter条件的所有结果时减少Graph API调用？

一、分页出现空页的原因 #

• 数据实时状态变更：你的Filter用到了viewpoint/isHidden eq false这种用户视角的状态，分页请求过程中，部分原本符合条件的聊天可能被标记为隐藏，导致当前页返回空，但后续页还有符合条件的数据。
• 游标与数据变更冲突：分页请求期间，如果有聊天被删除或不再满足Filter条件，当前游标指向的位置可能没有有效数据，但游标本身还能推进到下一页，就会出现空页。
• API内部设计特性：Graph API的分页逻辑里，只要游标没到结果集末尾，哪怕当前页没数据，也会返回ODataNextLink，目的是确保不会遗漏后续可能存在的有效数据。

二、减少Graph API调用的方法 #

• 提高每页返回数量：默认每页返回20条，你可以通过$top参数调高，Teams Chats端点最多支持999条。修改初始请求：

var chats = await graphClient.Chats
                            .GetAsync(requestConfiguration =>
                            {
                                requestConfiguration.QueryParameters.Filter = "chatType eq 'group' and topic ne null and viewpoint/isHidden eq false";
                                requestConfiguration.QueryParameters.Top = 999; // 设置最大每页条数
                            });

• 用增量查询（Delta Query）：如果是定期同步聊天数据，而非一次性全量获取，用Teams Chats的Delta API，它只返回上次查询后新增或变更的聊天，避免重复全量调用。
• 优化Filter条件：让Filter更精准，比如加时间范围过滤（lastUpdatedDateTime ge 2024-01-01T00:00:00Z），缩小查询范围，自然减少分页次数。
• 正确处理空页：遇到空页别直接终止循环，继续跟着ODataNextLink走直到链接为空，同时跳过空页的无效遍历：

while (true)
{
    if (chats.Value != null)
    {
        foreach (var chat in chats.Value)
        {
            chatsAll.Add(chat);
        }
    }

    if (!string.IsNullOrEmpty(chats.OdataNextLink))
    {
        chats = await graphClient.Chats
            .WithUrl(chats.OdataNextLink).GetAsync();
    }
    else
    {
        break;
    }
}

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