Google Apps Script迭代器报错：文件夹层级分类故障求助

核心报错原因 #

你遇到的Exception: Cannot retrieve next object: the iterator has reached the end.错误，主要由以下几个问题导致：

1. 变量定义顺序错误：
   你先调用locBase.getFoldersByName()，但locBase是在之后才定义的，这会导致初始的masterFolder基于未定义的locBase创建，后续操作必然异常。

2. 迭代器重复调用next()未检查边界：
   FolderIterator是一次性的，调用next()后指针会移动，若没有剩余元素再调用就会触发迭代器末尾错误。比如在else分支中，你先通过masterFolder.next()获取主文件夹，之后又再次调用masterFolder.next()，此时迭代器已经耗尽。

3. 创建文件夹后混淆对象类型：
   当你用createFolder()创建文件夹时，返回的是Folder对象，而非FolderIterator。但你之后错误地对这个Folder对象调用next()方法，不符合API规范。

4. 使用JavaScript关键字作为变量名：
   class是JS的保留关键字，用作变量名会引发语法冲突，导致代码逻辑异常。

修正后的代码 #

以下是修复所有问题后的完整代码片段，同时优化了文件夹查找逻辑，避免迭代器滥用：

// 先定义locBase，再使用它
var locBase = DriveApp.getFileById("DOCUMENT_ID").getParents().next();
var course = dataBase.getRange("L" + row).getValue();
// 替换关键字class为className，规避语法冲突
var className = dataBase.getRange("M" + row).getValue();

// 查找主文件夹
var masterFolderIterator = locBase.getFoldersByName("individual_documents");
var masterFolder;

// 处理主文件夹：存在则获取，不存在则创建
if (masterFolderIterator.hasNext()) {
  masterFolder = masterFolderIterator.next();
} else {
  masterFolder = locBase.createFolder("individual_documents");
}

// 处理课程文件夹：存在则获取，不存在则创建
var courseFolderIterator = masterFolder.getFoldersByName(course);
var courseFolder;
if (courseFolderIterator.hasNext()) {
  courseFolder = courseFolderIterator.next();
} else {
  courseFolder = masterFolder.createFolder(course);
}

// 处理班级文件夹：存在则获取，不存在则创建
var classFolderIterator = courseFolder.getFoldersByName(className);
var classFolder;
if (classFolderIterator.hasNext()) {
  classFolder = classFolderIterator.next();
} else {
  classFolder = courseFolder.createFolder(className);
}

// 移动文档到目标文件夹
document.moveTo(classFolder);

关键优化点 #

• 变量顺序调整：确保locBase先定义再使用，避免未定义错误。
• 分离迭代器与文件夹对象：每次查找文件夹时，先通过迭代器判断是否存在，再将文件夹对象赋值给单独变量，避免重复调用next()导致的迭代器耗尽。
• 替换关键字变量名：将class改为className，规避语法冲突。
• 扁平化逻辑：把嵌套的if-else拆分为独立的文件夹判断步骤，更易维护且逻辑清晰。

内容的提问来源于stack exchange，提问作者Asier Párraga