邮件CSV内容导入Google Sheet脚本故障排查求助

以下是针对你脚本失效的逐一排查点和修正方案：

1. 核心排查方向 #

邮件搜索匹配失败 #

• 检查邮件主题格式：确认实际邮件主题的日期格式是否为YYYY-MM-DD，如果是其他格式（比如YYYY/MM/DD），原代码构造的subject会不匹配，导致搜不到线程。
• 临时移除is:unread测试：如果邮件已被误标记为已读，is:unread会过滤掉目标邮件，可以先改成var threads = GmailApp.search("subject:" + subject)测试。
• 主题含特殊字符：如果主题里有引号或特殊符号，需要用引号包裹搜索关键词，比如：

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

工作表对象获取失败 #

如果工作表名称拼写错误，或者不在当前激活的表格中，sheet会返回null，后续写入操作直接失败。建议添加校验：

if (!sheet) {
  Logger.log("找不到指定工作表：" + sheetName);
  return;
}

CSV解析异常 #

• 编码问题：部分CSV可能使用非UTF-8编码（如GBK），直接getDataAsString()会导致乱码，解析失败。可以指定编码：

  var csvData = attachment.getDataAsString("UTF-8"); // 或尝试"GBK"
  

• 分隔符问题：如果CSV用制表符或其他符号分隔，需指定分隔符：

  var csv = Utilities.parseCsv(csvData, "\t"); // 替换为实际分隔符
  

日期计算错误 #

原代码取两天前的日期，如果你的每日报告是昨天的，应该改为date.setDate(date.getDate() - 1)，否则会搜索错误日期的邮件。

2. 修正后的完整代码 #

添加了日志、错误校验和更鲁棒的处理逻辑：

function importCSVFromEmail() {
  var sheetName = "Median Values";
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
  
  // 校验工作表是否存在
  if (!sheet) {
    Logger.log("错误：未找到工作表「" + sheetName + "」");
    return;
  }

  // 计算目标日期（根据实际需求调整-1或-2）
  var date = new Date();
  date.setDate(date.getDate() - 1); // 改为昨天的日期，按需调整
  var year = date.getFullYear();
  var month = ("0" + (date.getMonth() + 1)).slice(-2);
  var day = ("0" + date.getDate()).slice(-2);
  var prefix = "Mfare Report";
  var subject = prefix + " " + year + "-" + month + "-" + day;
  Logger.log("正在搜索主题：" + subject);

  // 搜索邮件（先移除is:unread测试，确认后再加回）
  var threads = GmailApp.search(`subject:"${subject}"`);
  Logger.log("找到匹配邮件线程数：" + threads.length);

  if (threads.length === 0) {
    Logger.log("未找到匹配的邮件，请检查主题格式或日期");
    return;
  }

  for (var i = 0; i < threads.length; i++) {
    var messages = threads[i].getMessages();
    for (var j = 0; j < messages.length; j++) {
      var attachments = messages[j].getAttachments();
      Logger.log("第" + (j+1) + "封邮件的附件数：" + attachments.length);
      
      for (var k = 0; k < attachments.length; k++) {
        var attachment = attachments[k];
        Logger.log("附件" + (k+1) + "类型：" + attachment.getContentType());
        
        // 兼容更多CSV类型（部分邮件可能返回application/csv）
        if (attachment.getContentType().match(/text\/csv|application\/csv/)) {
          try {
            // 尝试UTF-8编码，若乱码可改为GBK
            var csvData = attachment.getDataAsString("UTF-8");
            var csv = Utilities.parseCsv(csvData);
            
            if (csv.length === 0) {
              Logger.log("CSV内容为空");
              continue;
            }
            
            // 写入数据到工作表
            sheet.getRange(sheet.getLastRow() + 1, 1, csv.length, csv[0].length).setValues(csv);
            messages[j].markRead();
            Logger.log("成功导入CSV数据");
          } catch (e) {
            Logger.log("处理CSV时出错：" + e.message);
          }
        }
      }
    }
  }
}

3. 调试技巧 #

• 查看脚本日志：执行脚本后，点击编辑器顶部的「查看」→「日志」，检查每个步骤的输出，确认是搜索不到邮件、工作表不存在还是CSV解析失败。
• 手动授权：第一次运行脚本时，务必完成Gmail和Google Sheets的权限授权，否则脚本无法访问相关服务。

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