Microsoft Graph Ruby SDK邮件分页求助：如何使用odata_next_link？

你的核心问题在于误用了skip/top方式分页——这种方式依赖结果集的静态偏移，当文件夹内邮件有新增、删除或排序变化时，必然会出现重复或遗漏。正确的做法是利用响应返回的odata_next_link来构建下一页请求，因为这个链接包含了服务端生成的分页上下文，能保证分页的连续性。

以下是修改后的代码实现，直接基于odata_next_link实现正确分页：

begin
  # 初始化第一页请求参数
  params = MicrosoftGraph::Users::Item::MailFolders::Item::Messages::Delta::DeltaRequestBuilder::DeltaRequestBuilderGetQueryParameters.new
  params.select = %w[sender subject body from toRecipients sentDateTime ccRecipients]
  params.filter = "receivedDateTime ge 2025-06-04T00:00:00Z"
  params.top = 100
  request_config = MicrosoftKiotaAbstractions::RequestConfiguration.new
  request_config.query_parameters = params

  # 初始请求构建器
  current_builder = inbox_request_builder.messages.delta
  messages_fiber = current_builder.get(request_config)

  while (response = messages_fiber.resume)
    # 处理当前页邮件
    response.value.each do |message|
      messages[message.id] = message
    end

    # 检查是否存在下一页链接
    if response.respond_to?(:odata_next_link) && response.odata_next_link.present?
      # 用next_link创建新的请求构建器，复用原请求的adapter
      current_builder = MicrosoftGraph::Users::Item::MailFolders::Item::Messages::Delta::DeltaRequestBuilder.new(
        response.odata_next_link,
        inbox_request_builder.request_adapter
      )
      # 下一页请求无需重复传参，next_link已包含所有必要参数
      messages_fiber = current_builder.get
    else
      # 无下一页，终止循环
      break
    end
  end
rescue FiberError
  # 处理请求终止异常
end

关键说明 #

1. 放弃skip参数：不再通过递增skip来分页，避免数据变动导致的重复问题。
2. 复用next_link：服务端返回的odata_next_link包含了分页所需的所有上下文（包括delta令牌、筛选条件、分页数量等），直接用它创建新的请求构建器即可。
3. 适配gem结构：通过原请求的request_adapter来初始化新的DeltaRequestBuilder，确保请求的身份验证和配置一致。

如果发现响应中next_link的属性名是@odata.next_link而非odata_next_link，可以用以下方式获取：

next_link = response.instance_variable_get('@odata_next_link')

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