Google Apps Script其他用户运行报迭代器已达末尾异常排查

云原生阿岚

2026-9-1

问题原因

这个报错就是Google Drive权限机制导致的，核心是两个配置没做对：

最常见的原因是Web App部署时的执行身份选错了。你现在大概率选的是「以访问应用的用户身份执行」，这种模式下所有脚本操作都用当前打开表单的同事账号权限跑。你只给同事开了目标父文件夹的编辑权限，但没给绑定脚本的Google表格本身开权限的话，同事账号调用DriveApp.getFileById()拿到的文件元数据是残缺的，无权读取文件的父文件夹列表，迭代器直接返回空，调用.next()就会抛你遇到的错。
少数情况是权限范围不足：如果表格放在共享云端硬盘里，默认的DriveApp基础权限可能枚举不到共享盘内的文件夹层级，也会返回空迭代器。
你之前加了hasNext()判断还是拿不到结果，不是遍历逻辑写错了，是Google遇到权限不足的情况不会直接抛无权限错误，只会返回空迭代器，看起来就像文件根本没有父文件夹一样。

修复步骤

按优先级操作就行，第一步做完基本就能解决问题：

修正Web App部署配置（必做）
打开脚本编辑器，点右上角「部署」-「管理部署」，选中当前在用的部署点编辑：
- 「执行身份」直接选我（你的账号邮箱）
- 「谁可以访问」选组织内所有人
  保存后重新部署新版本即可。这个配置下不管哪个同事打开表单，脚本全程用你作为文件所有者的权限执行，不需要给同事挨个开表格、上层文件夹的权限，也不会有权限不足的问题，正好匹配你做内部上传表单的需求，所有上传的文件都会统一存在你指定的文件夹里，不会出现权限错乱。

补全容错逻辑（建议做）
把原来直接调用.next()获取父文件夹的逻辑加个判断，避免配置错的时候直接抛看不懂的系统错误，替换uploadFiletoDrive里的对应代码：

function uploadFiletoDrive(folderName){
  const ssId = SpreadsheetApp.getActiveSpreadsheet().getId();
  const parentIterator = DriveApp.getFileById(ssId).getParents();
  // 增加权限校验
  if (!parentIterator.hasNext()) {
    throw new Error("父文件夹访问失败，请检查脚本部署权限配置");
  }
  const parentFolder = parentIterator.next();

  // 原有逻辑保持不变
  Logger.log(ssId)
  Logger.log(parentFolder)
 
  const subFolders = parentFolder.getFolders();
  while (subFolders.hasNext()) {
    let folder = subFolders.next();
    Logger.log(folder.getName())
    if (folder.getName() === folderName) {
      Logger.log("Folder exists")
      Logger.log("Folder SSID : "+folder.getId())
      return folder.getId();
    }
  }
   Logger.log("Folder Creating")
  const folder = parentFolder.createFolder(folderName);
   Logger.log("New Folder SSID : "+folder.getId())
  return folder.getId(); 
}

特殊场景补全（第一步做完还报错再操作）
如果改完部署配置还是有问题，先把绑定脚本的Google表格本身也给组织内用户开至少查看权限，不要只共享父文件夹；如果表格存在共享云端硬盘里，就打开项目设置，勾选「显示appsscript.json清单文件」，在清单文件的oauthScopes配置里加上全量Drive权限：
```
"oauthScopes": [
  "https://www.googleapis.com/auth/spreadsheets.currentonly",
  "https://www.googleapis.com/auth/drive"
]
```
保存后重新给脚本授权即可。

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