部署的Web App执行报错：Unauthorized 401 error（execute as me）

API 探路者

2026-5-19

问题分析与解决方案

首先，我们来拆解你遇到的核心矛盾点：Web App在开放权限（所有知道链接的人）时，以「execute as me」身份能正常操作Drive；但限制为特定邮箱后，虽然能创建带HTML内容的Google Doc，却无法完成删除表格+新建文件的操作。这说明部分Drive权限是生效的，但针对特定资源的操作触发了新的权限校验逻辑，大概率和OAuth scope范围、token的有效权限，或是Web App权限限制后的身份验证流程变化有关。

可能的原因及排查步骤

1. OAuth Scope 范围不足

当Web App权限限制为特定用户时，Google可能会收紧对OAuth token的scope校验。开放权限时脚本能自动获取足够的Drive权限，但限制用户后，脚本的默认scope可能只包含了Web App的基础权限，缺少Drive读写所需的完整范围。

解决方法：

在脚本编辑器中，依次点击「项目设置」→「显示「appsscript.json」清单文件」。
打开appsscript.json，确认oauthScopes字段包含Drive操作所需的权限，比如：
```
"oauthScopes": [
  "https://www.googleapis.com/auth/drive",
  "https://www.googleapis.com/auth/script.webapp.deploy"
]
```
（如果只需操作特定文件夹，可用更精细的https://www.googleapis.com/auth/drive.file，但要确保目标文件夹已共享给脚本的运行身份「你自己」）
保存后重新部署Web App，确保新的scope生效。

2. 错误使用了用户的Token而非脚本的Token

你提到尝试传递token但执行报错，这里要注意：当Web App设置为「execute as me」时，脚本默认使用**你的身份（开发者）**的OAuth token操作Drive；如果手动传递了请求用户的token，并在代码中用这个token调用Drive API，就会以用户身份执行——而用户大概率没有权限删除你Drive中的表格。

验证方式：
在代码中打印当前使用的token权限范围，确认是否是脚本的身份：

function doGet(e) {
  // 打印脚本的OAuth token（execute as me的身份）
  const scriptToken = ScriptApp.getOAuthToken();
  console.log('Script Token Scope:', getTokenScope(scriptToken));
  
  // 如果代码中使用了用户传递的token，对比两者的scope
  const userToken = e.parameter.token;
  if (userToken) {
    console.log('User Token Scope:', getTokenScope(userToken));
  }
  
  // 后续操作逻辑...
}

// 辅助函数：获取token的权限范围
function getTokenScope(token) {
  const response = UrlFetchApp.fetch('https://oauth2.googleapis.com/tokeninfo?access_token=' + token);
  const data = JSON.parse(response.getContentText());
  return data.scope;
}

如果发现用户token的scope不包含Drive读写权限，说明你误用了用户身份执行操作，应该改用脚本默认的DriveApp或UrlFetchApp配合脚本token调用Drive API。

3. 目标文件/文件夹的权限隐性限制

虽然你是Drive表格的所有者，但当Web App权限限制为特定用户时，Google可能会对「execute as me」的请求添加额外校验：比如要求请求用户至少有目标文件的查看权限（这是容易被忽略的细节——即使脚本用你的身份运行，当请求来自受限用户时，Google可能会检查该用户是否能「触及」目标资源）。

验证方式：

把目标表格所在的文件夹，共享给受限的特定邮箱（至少赋予查看权限）。
重新测试Web App的删除+新建操作，看是否恢复正常。

4. Web App部署后的权限缓存问题

有时候重新部署Web App后，权限设置不会立即生效，尤其是涉及OAuth scope变更时。

解决方法：

完全删除旧的Web App部署，重新创建一个新的部署版本。
确保部署时「Who has access to the app」选择「Specific people」并添加目标邮箱，「Execute the app as」选择「Me」。

总结

你的情况最可能的原因是OAuth scope不足或误用了用户token。先从检查appsscript.json的scope开始，再验证代码中使用的token身份，应该就能定位问题。

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