Google People API的nextPageToken仅能获取下一页？能否实现传统分页？

核心问题解析 #

你提到的情况完全准确：Google People API 的nextPageToken是游标式分页的核心，它只能用来获取当前页的下一页数据，无法通过页码计算直接跳转到指定页。具体表现为：

• 第一页请求返回的nextPageToken仅能用于请求第二页；
• 只有拿到第二页返回的nextPageToken，才能请求第三页；
  如果用户直接点击第三页按钮，你没有对应token的话根本无法直接获取第三页数据——要是错误复用第一页的token，返回的只会是第二页，而非第三页。

传统分页模式的可行性 #

这种游标分页机制本质上不支持传统的“直接跳转到任意页码”的分页模式，它的设计初衷就是适配无限滚动（滚动加载下一页）这类场景。如果一定要实现传统页码跳转，只能通过额外的服务端逻辑弥补，但存在明显局限：

• 提前预取并缓存所有页的nextPageToken：首次请求时遍历获取所有页的token并存起来，用户点击指定页码时直接用对应token请求。但这种方式会有数据一致性问题（缓存期间API数据可能更新），且数据量越大，预取成本越高；
• 退而求其次，只提供「上一页/下一页」按钮，放弃直接跳转到指定页码的功能，完全贴合API的游标分页逻辑。

补充说明 #

你用pages = Math.ceil(data size / 100)计算总页数的方式，其实可以简化：Google People API 的listConnections接口会返回totalItems字段，直接提供总条数，不用自行计算。不过即便知道总页数，也无法跳过中间页直接请求目标页。

内容的提问来源于stack exchange，提问作者loveloper.dev