如何突破Octokit调用GitHub API获取超前提交的250条限制？

这是因为GitHub API的提交对比接口默认采用分页机制，单页最多返回100条结果，而你当前的调用没有处理分页逻辑，只拿到了前几页的内容（250条应该是默认每页30条时的8页左右）。要获取所有超前提交，需要通过Octokit的分页功能遍历所有结果，具体方法如下：

方法1：使用Octokit内置的paginate方法（推荐） #

Octokit提供的paginate方法可以自动遍历所有分页，无需手动处理Link头信息，直接拿到完整的提交列表。示例代码（JavaScript）：

const { Octokit } = require("@octokit/rest");
const octokit = new Octokit({ auth: "your-personal-access-token" });

// 获取所有超前提交
const getAllAheadCommits = async () => {
  const allCommits = await octokit.paginate(
    "GET /repos/{owner}/{repo}/compare/{base}...{head}",
    {
      owner: "复刻仓库的所有者",
      repo: "复刻仓库名称",
      base: "上游仓库的基准分支（如main）",
      head: "你的分支名称",
      per_page: 100 // 设置每页最大100条，减少请求次数
    },
    (response) => response.data.commits // 提取每一页的提交数据
  );
  return allCommits;
};

// 调用示例
getAllAheadCommits().then(commits => {
  console.log(`共获取到${commits.length}条超前提交`);
});

方法2：手动处理分页（自定义控制场景） #

如果需要更精细的控制（比如中途停止遍历、添加自定义延迟），可以手动跟踪分页参数和Link头：

const { Octokit } = require("@octokit/rest");
const octokit = new Octokit({ auth: "your-personal-access-token" });

const getAllAheadCommits = async () => {
  let allCommits = [];
  let page = 1;
  let hasNextPage = true;

  while (hasNextPage) {
    const response = await octokit.rest.repos.compareCommits({
      owner: "复刻仓库的所有者",
      repo: "复刻仓库名称",
      base: "上游仓库的基准分支",
      head: "你的分支名称",
      per_page: 100,
      page: page
    });

    allCommits = [...allCommits, ...response.data.commits];
    
    // 检查是否存在下一页
    const linkHeader = response.headers.link;
    hasNextPage = linkHeader?.includes('rel="next"');
    page++;
  }

  return allCommits;
};

注意事项 #

• 速率限制：GitHub API对认证请求的速率限制为每小时5000次，未认证请求仅60次。如果提交数量极大，建议添加适当延迟，或配置Octokit的重试机制（如new Octokit({ request: { retries: 3 } })）来处理速率限制响应。
• 权限验证：确保你的个人访问令牌（PAT）拥有repo权限，否则无法访问私有仓库的提交数据。

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