调用DriveApp.File的moveTo方法时出现意外错误排查

核心错误原因 #

触发Unexpected error while getting the method or property moveTo on object DriveApp.File的主要原因是：当"Shared Folder"已存在时，createBase()函数未将现有文件夹赋值给folder变量，导致函数返回undefined。调用docFile.moveTo(undefined)自然会触发错误。

其他潜在问题 #

1. 全局变量泄漏：maindocFile和docFile未用var声明，可能引发意外的变量冲突。
2. 表格行数获取不一致：使用SpreadsheetApp.getActiveSpreadsheet()而非已打开的ss对象，可能导致逻辑错误。
3. 共用文件ID获取错误：DriveApp.getFilesByName('Test')返回的是文件迭代器，而非文件ID，无法直接用于权限设置。
4. 共用文件检索范围过大：全局搜索"Test"文件，可能匹配到其他同名文件，而非目标文件夹中的共用文件。

修复后的完整代码 #

function createBase() { // 创建或获取共享文件夹及共用文件
  var folder;
  // 检查共享文件夹是否存在，存在则获取，不存在则创建
  if (DriveApp.getFoldersByName("Shared Folder").hasNext()) {
    folder = DriveApp.getFoldersByName("Shared Folder").next();
  } else {
    folder = DriveApp.createFolder("Shared Folder");
    var title = 'Test';    
    var doc = DocumentApp.create(title);
    var maindocFile = DriveApp.getFileById(doc.getId());
    maindocFile.moveTo(folder);
  }
  return folder;
}

function userFiles() {
  var id = "idString"; // 替换为你的表格ID
  var ss = SpreadsheetApp.openById(id);
  var sheet = ss.getSheetByName("Students");
  var numrows = ss.getDataRange().getNumRows(); // 从已打开的表格获取行数
  var sharedFolder = createBase(); // 提前获取共享文件夹，避免重复调用
  
  for (var i = 2; i <= numrows; i++) {
    var userName = sheet.getRange(i,1).getValue().toString();
    var email = sheet.getRange(i,2).getValue().toString();
    var specificDocName = "Specific Doc - " + userName;
    
    // 检查共享文件夹中是否已存在学生专属文档
    var docExists = false;
    var files = sharedFolder.getFilesByName(specificDocName);
    if (files.hasNext()) {
      docExists = true;
    }
    
    if (!docExists) {
      var doc = DocumentApp.create(specificDocName);
      var docFile = DriveApp.getFileById(doc.getId());
      docFile.moveTo(sharedFolder); // 移动到正确的共享文件夹
      
      // 设置学生对专属文档的编辑权限
      var docId = doc.getId();
      var customMessage = "This is your own document!";
      var resource = {role: "writer", type: "user", value: email};
      Drive.Permissions.insert(resource, docId, {emailMessage: customMessage});
      
      // 获取共享文件夹中的共用文件并设置学生只读权限
      var mainDocIterator = sharedFolder.getFilesByName('Test');
      if (mainDocIterator.hasNext()) {
        var mainDocId = mainDocIterator.next().getId();
        var resource2 = {role: "reader", type: "user", value: email};
        var maincustomMessage = "This is our main document";
        Drive.Permissions.insert(resource2, mainDocId, {emailMessage: maincustomMessage});
      }
    }
  }
}

关键修复点说明 #

• createBase()函数修复：初始化folder变量，无论文件夹是否存在都确保其被赋值，返回有效的文件夹对象。
• 避免重复调用createBase()：在循环外提前获取共享文件夹，提升效率并减少Drive API调用次数。
• 专属文档存在性检查优化：仅在共享文件夹内搜索，避免全局搜索的不确定性。
• 共用文件ID获取修复：从共享文件夹中获取"Test"文件，确保拿到正确的目标文件ID。
• 变量作用域修正：所有变量均用var声明，避免全局泄漏。

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