GitHub组织所有者调用仓库列表API，返回私有仓库数与Web端显示值不符

返回结果不全的核心原因与对应解决逻辑如下：

核心触发原因 #

GitHub REST API 的列表类接口默认开启分页截断，无显式配置时单页默认仅返回30条结果，与你实际拿到约30个仓库的现象完全匹配。之前追加的?type=all属于仓库类型过滤参数，仅控制返回的仓库类型范围，和分页逻辑无关，因此不会改变返回数量。

具体排查与解决步骤 #

• 第一步先验证分页状态：使用curl -i发起的请求会自动输出完整响应头，找到头信息里的Link字段，如果存在rel="next"标识的链接，就说明当前返回只是全量数据的第一页，不存在接口异常。
• 调整单页返回上限：给请求追加per_page=100参数，这是GitHub允许的单页返回最大条目数，设置完成后112个仓库仅需2次请求即可拉完全量，调整后的请求示例为：
  curl -i -u username:oauth-token https://api.github.com/orgs/org/repos?per_page=100&type=all
• 逐页遍历拉取：按照响应头Link字段返回的下一页地址，逐次调整page参数发起请求，直到响应头中不再出现rel="next"标识，即完成全量仓库拉取。
• 权限交叉验证：如果调整分页后返回的仓库总数仍和控制台的112个对不上，检查所用OAuth Token的权限范围：拉取组织私有仓库需要Token具备完整的repo权限，如果Token仅开放公开仓库读取权限，私有仓库不会被纳入返回结果，可通过响应头中的X-GitHub-Private-Total-Count数值对照控制台的私有仓库数量，快速判断是否为权限问题。

常见误区澄清 #

• type=all参数的作用是覆盖默认的过滤规则，确保返回结果包含私有、公开、归档、模板等所有类型的仓库，使用逻辑本身没有问题，但无法解决分页截断导致的返回不全问题。
• 控制返回数量的分页参数只有per_page和page，和过滤类参数的作用完全独立，仅追加过滤参数不会触发接口返回全量数据。

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