已安装GitHub App令牌丢失后的获取方案及私有仓库访问问题

一、已安装App的用户令牌丢失后的官方解决方案 #

不需要用户卸载重装App，官方推荐直接复用GitHub App授权流程，步骤如下：

• 当检测到用户无有效令牌（如换浏览器、Cookie清空），直接跳转至你的App授权页面：https://github.com/apps/[你的App名称]/installations/new
• 用户登录GitHub后，系统会自动识别已安装状态，只需点击确认授权即可，无需重新配置权限
• 授权完成后，GitHub会携带code重定向回站点，后续流程和首次安装一致：通过Gatekeeper将code兑换为新令牌并存入Cookie

这种方式无需提前判断用户是否已安装App，GitHub会自动处理已安装/未安装的分支逻辑，用户操作极简。

推荐参考GitHub官方的github-app-js示例项目，核心逻辑围绕授权回调处理、令牌兑换及过期/丢失时的重定向展开。

二、私有仓库访问失败的原因与修正 #

你遇到的问题核心是OAuth令牌权限范围不足，而GitHub App可申请精细的仓库权限，这也是你选择App而非单纯OAuth的原因。

问题排查点 #

1. OAuth令牌权限缺失：调用https://api.github.com/user接口，查看返回的scope字段是否包含repo（该权限覆盖私有仓库访问），若只有public_repo则无法访问私有仓库
2. API调用细节问题：
   • 调用/user/repos时，参数type=private需配合repo权限才能返回结果
   • 搜索接口/search/repositories对私有仓库的索引存在延迟，且同样需要repo权限，优先推荐使用/user/repos接口获取私有仓库列表

代码修正示例（以/user/repos为例） #

确保令牌拥有repo权限后，调用逻辑可保持不变，建议指定API版本提升稳定性：

const apiUrl = 'https://api.github.com/user/repos';
const params = {type: 'private'};

fetch(`${apiUrl}?${new URLSearchParams(params)}`, {
  method: 'GET',
  headers: {
    'Authorization': `token ${accessToken}`,
    'Accept': 'application/vnd.github.v3+json',
  }
})
  .then(response => {
    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
    return response.json();
  })
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

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