Google Apps Script使用UrlFetchApp与DocumentApp时授权失败求助

我之前开发Google Workspace插件时也碰到过几乎一模一样的问题，结合你给出的信息，大概率是OAuth范围的自动检测与声明冲突，或者缓存异常导致的。下面给你几个实用的排查和解决方向：

1. 手动明确声明OAuth范围（最关键的一步） #

Apps Script默认会自动推断脚本需要的OAuth范围，但当混合使用多种服务（比如DocumentApp、DriveApp、UrlFetchApp）时，自动推断的范围可能出现冲突，或者Google的授权系统无法正确识别。解决方法是直接在项目的清单文件里手动指定所有需要的范围：

• 打开脚本编辑器，点击右上角的「项目设置」
• 勾选「显示"appsscript.json"清单文件」
• 打开appsscript.json文件，将oauthScopes数组替换为你列出的5个范围，确保没有遗漏或多余的项：

  {
    "oauthScopes": [
      "https://www.googleapis.com/auth/documents",
      "https://www.googleapis.com/auth/drive",
      "https://www.googleapis.com/auth/script.container.ui",
      "https://www.googleapis.com/auth/script.external_request",
      "https://www.googleapis.com/auth/script.send_mail"
    ],
    "timeZone": "你的时区（比如Asia/Shanghai）",
    "runtimeVersion": "V8"
  }
  

• 保存文件后，重新触发插件的授权流程，这时候Google会明确识别你需要的所有权限，避免自动推断带来的混乱。

2. 替换UrlFetchApp请求的HTTP协议 #

你示例代码里用的是http://example.com，建议换成HTTPS协议（https://example.com）。Google Apps Script对非HTTPS的外部请求有严格的安全限制，虽然这不一定直接导致500错误，但可能触发额外的安全校验，间接干扰授权流程。修改后的代码：

function reproduceError() { 
  var doc = DocumentApp.getActiveDocument(); 
  return UrlFetchApp.fetch("https://example.com"); 
}

3. 清除旧授权缓存，重新授权 #

有时候旧的授权记录会和新的范围声明冲突，导致授权流程异常：

• 关闭所有Google Docs和脚本编辑器的标签页
• 打开你的Google账号「安全」设置，找到「第三方应用访问」，找到你的插件名称并移除它的访问权限
• 重新打开插件，触发新的授权流程，看看是否还会跳转到500错误页

4. 确认使用最新的V8运行时 #

旧的Apps Script运行时可能存在OAuth兼容问题，确保你使用的是V8引擎：

• 在脚本编辑器的「运行」菜单里，检查是否有「启用新应用脚本运行时」的选项，若有则启用
• 或者直接在appsscript.json里设置"runtimeVersion": "V8"（如步骤1的示例）

以上方法里，手动声明OAuth范围是解决这类问题最有效的手段，建议优先尝试。

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