使用RestAssured调用GitLab API时如何一次性获取全部分页Issue数据

• GitLab API不存在可直接返回全量数据的配置项，单页返回条数硬上限为100，无论传多大的per_page参数都会被截断到100。
• 你之前设置pagination=keyset没生效的核心原因：keyset（游标分页）不是全量拉取开关，只是用来替代传统页码偏移分页的高性能分页模式，本身不会自动聚合多页数据；且keyset模式要求必须搭配order_by、sort参数使用，参数缺失时接口会自动切回普通offset分页，不会按照游标模式工作。
• 额外注意：GitLab接口的查询参数全部为小写格式，比如筛选Issue状态的参数是state，如果传大写的STATE接口无法识别，会返回全状态的Issue，和你预期的仅拉取opened状态数据的目标不符。

pagination=keyset的游标模式仅解决大页码下offset分页查询性能差的问题，全量拉取的核心逻辑都是逐页请求直到无后续数据，再把多页结果聚合成统一返回结构，不存在“一键拉全量”的捷径。

• 传统offset分页拉取流程
  1. 从第1页开始，固定设置per_page=100发起请求
  2. 每次请求完成后，从响应头读取x-next-page字段值
  3. 若该字段为空或值为0，代表已拉取到最后一页，终止循环
  4. 把每次请求返回的Issue数组合并到统一存储列表，最终封装成单个统一响应返回
• keyset游标模式拉取流程（适合数据量较大的场景，避免offset分页深查询性能差的问题）
  1. 必须强制配置三个必填参数，否则参数不生效：pagination=keyset、order_by=id（必须选全局唯一的排序键，推荐用Issue主键id）、和排序方向匹配的sort参数
  2. 首次请求不传游标参数，从第一页开始拉取
  3. 每次请求完成后，从响应头读取x-next-page的游标值（该值不是页码数字，是序列化后的游标字符串）
  4. 下一次请求把游标值作为查询参数传入，直到响应头不再返回x-next-page字段，终止拉取
  5. 同样把各页返回的Issue数据做合并，封装成统一响应返回

// 聚合存储所有分页的Issue数据
List<Map<String, Object>> allIssues = new ArrayList<>();
int currentPage = 1;
final int MAX_PER_PAGE = 100;

while (true) {
    Response response = RestAssured.given()
            .log().all()
            .accept("json")
            .header("PRIVATE-TOKEN", TOKEN)
            .queryParam("state", "opened")
            .queryParam("per_page", MAX_PER_PAGE)
            .queryParam("page", currentPage)
            .when().get(url)
            .then()
            .extract()
            .response();

    // 合并当前页数据到总列表
    List<Map<String, Object>> pageData = response.jsonPath().getList("$");
    allIssues.addAll(pageData);

    // 解析下一页标识
    String nextPageMark = response.getHeader("x-next-page");
    // 无下一页时终止循环
    if (nextPageMark == null || nextPageMark.isBlank()) {
        break;
    }
    // offset分页模式下，直接将返回的页码值作为下一次请求的页码
    currentPage = Integer.parseInt(nextPageMark);
}

// 把聚合后的全量数据封装为统一Response对象返回，匹配你需要的统一响应格式
return ResponseBuilder.response().setBody(allIssues).build();

• 单页100条是硬限制，没有任何配置可以突破，传超过100的per_page值会被接口自动截断
• 数据量较大时建议给循环加固定间隔休眠，避免触发接口访问频率限制
• 如果使用keyset模式，不需要传page参数，每次把响应头拿到的游标值作为cursor查询参数传入即可，其余聚合逻辑和上述代码一致

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