使用Apps Script访问GitHub仓库遇权限及未知错误求助

之前通过Google Apps Script将Google Drive文件同步到GitHub的流程突然失效，尝试验证GitHub令牌时出现401错误（但本地curl请求正常），另一段测试代码报「未知错误」，可按以下步骤排查：

一、修正请求头格式 #

GitHub API对请求头有明确规范，GAS的UrlFetchApp默认行为可能不符合要求：

• 将Authorization头格式从token <token>改为Bearer <token>，同时强制添加User-Agent字段（GitHub API强制要求），示例代码修改如下：

headers: {
  "Authorization": "Bearer " + token,
  "User-Agent": "Google-Apps-Script"
}

二、获取完整错误信息 #

开启muteHttpExceptions: true后，打印完整响应内容，不要仅捕获错误message：

try {
  var response = UrlFetchApp.fetch(url, options);
  Logger.log("响应状态码: " + response.getResponseCode());
  Logger.log("完整响应内容: " + response.getContentText());
  // 后续逻辑...
} catch (e) {
  Logger.log("捕获错误: " + e.message);
  if (response) {
    Logger.log("错误响应内容: " + response.getContentText());
  }
}

通过完整响应可精准定位是权限、路径还是请求格式的具体问题。

三、重新授权脚本并检查令牌权限 #

• 在脚本编辑器中点击「运行」→「授权」，重新完成OAuth授权流程，清除可能的权限缓存。
• 登录GitHub令牌管理页面，确认令牌已勾选repo（私有仓库）或public_repo（公有仓库）权限，避免权限范围不足。

四、测试基础API端点 #

先调用最简单的用户信息端点验证请求有效性，排除仓库路径问题：

function testGitHubAuth() {
  var token = "你的GitHub令牌";
  var url = "https://api.github.com/user";
  var options = {
    method: "get",
    muteHttpExceptions: true,
    headers: {
      "Authorization": "Bearer " + token,
      "User-Agent": "Google-Apps-Script"
    }
  };
  var response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getContentText());
}

如果该请求成功，说明令牌和请求格式无问题，故障出在仓库路径或特定端点的权限配置上。

五、排查脚本环境细节 #

• 检查脚本编辑器「设置」→「时区」，确保与本地时区一致，避免时间同步异常导致的请求问题。
• 确认代码中的令牌无多余空格、换行符，直接复制GitHub生成的原始令牌，不要手动编辑。

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