Google Apps Script问题：Gmail中CSV无法导入指定Google Sheets

问题背景：
作为Google Apps Script新手，脚本可在某工作表正常运行，更换目标工作表、修改邮件主题和工作表名称后，执行无报错但CSV数据未导入；其他用户运行相同脚本可成功导入，本人能在收件箱看到目标邮件，脚本代码与可用版本一致。需求是定时触发脚本，从Gmail提取指定主题邮件的CSV附件，追加数据到Google Sheets指定工作表末尾。

1. Gmail搜索语法错误（核心问题） #

原代码中Gmail搜索语句存在语法错误：

var threads = GmailApp.search('subject:' + subject + '"',0,1);

拼接后会生成subject:Brand metric JPI report"，多余的尾引号会导致搜索匹配失败，找不到目标邮件线程。

修复方法：修正搜索语句的引号位置，正确将主题用双引号包裹：

var threads = GmailApp.search('subject:"' + subject + '"', 0, 1);

或使用模板字符串提升可读性：

var threads = GmailApp.search(`subject:"${subject}"`, 0, 1);

2. 工作表名称匹配问题 #

确认getSheetByName('Ended Campaigns')中的工作表名称与实际完全一致，包括大小写、空格、特殊字符。若实际表名存在大小写差异或空格错误，会返回null，后续写入操作会静默失败。

验证方法：在脚本中添加日志检查工作表是否存在：

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Ended Campaigns');
if (!sheet) {
  Logger.log("未找到指定工作表：Ended Campaigns");
  return;
}

3. CSV附件判断逻辑局限性 #

原代码仅通过attachment.getContentType() === "text/csv"判断，但部分CSV附件的Content-Type可能是application/csv或其他变种，导致跳过匹配。

优化方法：结合文件名判断更可靠：

if (attachment.getFileName().toLowerCase().endsWith('.csv')) {
  // 后续解析逻辑
}

4. 权限与授权问题 #

虽然能看到邮件，但脚本的授权可能存在异常：

• 确认脚本用本人账号授权运行，且授权时勾选了Gmail和Google Sheets的权限
• 若使用定时触发，检查触发器的运行账号是否为本人账号，且权限未过期

5. CSV数据解析异常 #

检查CSV文件是否为空，或解析后的数据是否为空数组。原代码中slice(1)会移除表头，若CSV只有表头一行，csvData会变成空数组，导致无数据写入。

验证方法：查看脚本日志中的Email Contents，确认csvData是否有有效数据。若CSV可能仅含表头，可调整逻辑：

var csvData = Utilities.parseCsv(attachment.getDataAsString());
if (csvData.length > 1) {
  csvData = csvData.slice(1); // 仅当有数据行时移除表头
} else {
  Logger.log("CSV文件仅包含表头，无数据行");
  continue;
}

修复后的完整脚本 #

function ExtractCSVFromGmailAndImport() {
  var subject = "Brand metric JPI report";
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Ended Campaigns');
  
  // 检查工作表是否存在
  if (!sheet) {
    Logger.log("未找到指定工作表：Ended Campaigns");
    return;
  }

  // 修正Gmail搜索语法
  var threads = GmailApp.search(`subject:"${subject}"`, 0, 1);
  if (threads.length > 0) {
    var messages = threads[0].getMessages();
    if (messages.length > 0) {
      var message = messages[0];
      var attachments = message.getAttachments();
      for (var i = 0; i < attachments.length; i++) {
        var attachment = attachments[i];
        // 结合文件名判断CSV附件
        if (attachment.getFileName().toLowerCase().endsWith('.csv')) {
          var csvData = Utilities.parseCsv(attachment.getDataAsString());
          // 处理仅表头的情况
          if (csvData.length <= 1) {
            Logger.log("CSV文件无有效数据行");
            continue;
          }
          csvData = csvData.slice(1); // 移除表头
          Logger.log("Email Contents: " + csvData);
          Logger.log("Last Row: " + sheet.getLastRow() + 1);
          sheet.getRange(sheet.getLastRow() + 1, 1, csvData.length, csvData[0].length).setValues(csvData);
        }
      }
    } else {
      Logger.log("未找到指定主题的邮件内容");
    }
  } else {
    Logger.log("未找到指定主题的邮件线程");
  }
}

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