Google脚本导入邮件至表格重复条目问题排查求助

你的脚本出现重复条目核心原因是没有对已处理的邮件做唯一标识校验——哪怕移除了线程标签，若脚本被重复触发（比如定时触发器重复执行、手动多次运行），未完成标签移除的邮件可能被再次抓取，或者脚本重启后没有历史处理记录，最终导致重复写入。

具体问题点 #

1. 仅依赖移除线程标签做去重：标签移除操作在写入Sheet之后，若脚本执行中断或重复触发，邮件可能被多次处理。
2. 未记录已处理邮件的唯一ID：无法在脚本执行时判断该邮件是否已经写入过Sheet，缺乏核心去重依据。

修复方案 #

通过记录已处理邮件的Message ID实现严格去重，同时优化处理逻辑的可靠性：

步骤1：新增已处理邮件ID的存储与校验

使用Google Apps Script的PropertiesService存储已处理的邮件ID，每次处理前先校验该ID是否已存在，避免重复写入。

步骤2：优化线程与消息的处理逻辑

确保每个消息仅被处理一次，同时将线程标签的移除操作放在该线程所有消息处理完成后，避免中间状态被重复抓取。

修改后的完整代码 #

function getEmails() {
  // 获取存储已处理邮件ID的属性服务
  var processedProps = PropertiesService.getUserProperties();
  var processedIds = processedProps.getProperty('processedMessageIds') || '';
  var processedIdSet = new Set(processedIds.split(',').filter(id => id));
  
  // 搜索带"Emprevo"标签的线程
  var threads = GmailApp.search('label:"Emprevo"', 0, 100);
  var sheet = SpreadsheetApp.getActive().getActiveSheet();
  var label = GmailApp.getUserLabelByName("Emprevo");
  var newRows = [];

  for (var i = 0; i < threads.length; i++) {
    var messages = threads[i].getMessages();
    for (var j = 0; j < messages.length; j++) {
      var message = messages[j];
      var messageId = message.getId();

      // 校验邮件是否已处理，已处理则跳过
      if (processedIdSet.has(messageId)) continue;

      var emailDate = message.getDate();
      var subject = message.getSubject();
      var body = message.getPlainBody();
      
      // 解析邮件数据
      var jobData = parseEmailBody(emailDate, subject, body);
      // 加入邮件ID（可选，可用于Sheet内直接校验）
      jobData.push(messageId);
      newRows.push(jobData);

      // 标记为已处理
      processedIdSet.add(messageId);
      message.markRead();
    }
    // 处理完线程内所有消息后再移除标签
    threads[i].removeLabel(label);
  }

  // 批量写入Sheet，提升执行效率
  if (newRows.length > 0) {
    sheet.getRange(sheet.getLastRow() + 1, 1, newRows.length, newRows[0].length).setValues(newRows);
  }

  // 更新已处理ID到属性服务
  processedProps.setProperty('processedMessageIds', Array.from(processedIdSet).join(','));
}

function parseEmailBody(emailDate, subject, body) {
  var senderRegex = /From: (.*?<(.+?)>)/;
  var matches = body.match(senderRegex);
  var sender = matches ? matches[1] : '';
  return [emailDate, subject, sender, body];
}

额外优化建议 #

• 若Sheet数据量较大，也可在Sheet最后一列存储邮件ID，每次处理前通过sheet.getDataRange().getValues()查询是否存在该ID（但PropertiesService的查询效率更高）。
• 检查定时触发器设置，确保没有重复配置导致脚本多次执行。

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