调用GitHub搜索API获取JavaScript仓库返回结果不一致是什么原因？

结果不一致的核心原因 #

• GitHub Search API 采用分布式节点部署，不同节点的星标计数、索引数据存在秒级同步延迟，当排名靠前的几个仓库星标差值极小时，不同节点返回的排序结果会出现波动
• 你当前的请求未配置GitHub身份认证，未认证的搜索接口限流为每小时10次，触发限流时接口会返回截断的分片数据而非全量排序结果，进一步加大了结果的随机性
• Top级JavaScript仓库的星标数实时变化，短时间内的用户点赞/取消点赞操作也会导致排名变动

修复方案 #

1. 给请求添加GitHub个人访问令牌（PAT）身份认证，认证后的搜索接口限流提升至每小时30次，同时可获取全量排序的稳定结果，PAT可在GitHub开发者设置中生成，无需额外授权范围
2. 给查询参数添加星标阈值过滤，缩小排序池范围，进一步降低波动
3. 若业务对结果一致性要求高，可增加本地缓存，固定间隔时间更新结果即可

修正后的请求代码示例 #

axios({
  headers: {
    Accept: 'application/vnd.github.v3+json',
    // 替换为你自己生成的PAT
    Authorization: 'token ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  },
  method: 'get',
  url: 'https://api.github.com/search/repositories',
  params: {
    q: 'language:JavaScript stars:>100000',
    sort: 'stars',
    order: 'desc',
    per_page: 3
  }
})
  .then(res => {
    console.log(res.data)
  })
  .catch(err => {
    console.log(err)
  })

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