Google Apps Script获取Gmail最后交互日期脚本报错排查

报错原因分析 #

报错TypeError: Cannot read properties of undefined (reading '0')出现在代码第12行，根源是数组索引越界：

• emails是通过getValues()获取的二维数组，数组索引从0开始
• 原循环使用i <= emails.length，当i等于emails.length时，emails[i]为undefined，访问[0]就会触发报错

修复及优化后的代码 #

/**
* @license MIT
* @author xfanatical. 
*/
function myFunction() {
  var ss = SpreadsheetApp.getActiveSpreadsheet()
  var emailsRange = ss.getRangeByName('Emails')
  var lastMessageDateRange = ss.getRangeByName('LastReceivedDate')
  
  var emails = emailsRange.getValues()
  // 修正循环逻辑：数组从0开始遍历，避免越界
  for (var i = 0; i < emails.length; i++) {
    // 处理空单元格，避免报错
    var email = emails[i][0]?.replace(/^\s+|\s+$/g, '') || ''
    if (email === '') {
      lastMessageDateRange.getCell(i + 1, 1).setValue('')
      continue
    }
    // 搜索与该邮箱的所有交互邮件（发送+接收），取最新线程
    var threads = GmailApp.search(`to:"${email}" OR from:"${email}"`, 0, 1)
    Logger.log('处理邮箱: ' + email)
    var targetCell = lastMessageDateRange.getCell(i + 1, 1)
    
    if (threads.length === 0) {
      targetCell.setValue('未找到')
    } else {
      // 直接取线程内最新的邮件
      var latestMessage = threads[0].getMessages().pop()
      var date = latestMessage.getDate()
      // 标准化日期格式
      var dateStr = Utilities.formatDate(date, Session.getScriptTimeZone(), "dd/MM/yyyy")
      targetCell.setValue(dateStr)
    }
  }
}

关键修复与优化点 #

• 修正循环索引：将for (var i = 1; i <= emails.length; i++)改为for (var i = 0; i < emails.length; i++)，严格遵循数组从0开始的索引规则，彻底解决越界问题
• 完善搜索范围：原代码仅搜索发送给目标邮箱的邮件，修改为to:"${email}" OR from:"${email}"，覆盖所有发送和接收的交互场景，符合需求
• 简化邮件获取逻辑：Gmail线程内的邮件按时间顺序排列，直接取最后一个元素即为最新邮件，无需倒序循环查找
• 增强鲁棒性：添加可选链?.处理空单元格，避免因邮箱列表有空值导致的报错
• 标准化日期格式：使用Google Apps Script内置的Utilities.formatDate工具格式化日期，比手动拼接更可靠，还可通过时区参数统一格式

内容的提问来源于stack exchange，提问作者Jorge Fernando García