迁移至V8 runtime后Google Apps Script生日邮件脚本故障求助

问题背景 #

该脚本用于Google Workspace自动发送员工生日邮件，在Rhino runtime下正常运行一年以上，2023年4月20日迁移至V8 runtime后失效，出现以下错误：

• The parameters (number[],String,String,(class)) don't match the method signature for MailApp.sendEmail.
• 将getValues改为getValue后，出现Invalid email: d错误
• 全量替换getValues为getValue后，出现DNS error: http://m错误

错误原因分析 #

1. 参数类型不匹配：V8 runtime对类型检查更严格，getValues()返回二维数组，直接使用emailAddress[i]会传入数组而非字符串，导致MailApp方法签名不匹配。
2. getValue使用错误：getValue()仅返回单个单元格的值，全量替换后无法遍历多行数据，导致获取到错误的邮箱/URL内容。
3. URL格式问题：空行或不完整的图片URL被传入UrlFetchApp.fetch()，引发DNS解析错误。

修复方案与代码修改 #

关键修改点 #

• 保留getValues()获取整列数据，但使用时取二维数组的子元素（[i][0]），确保传入字符串类型参数。
• 优化日期比较逻辑，统一提取月日进行匹配，避免依赖toString()的格式差异。
• 限制循环范围为实际数据行，避免处理空行。
• 增强图片URL的有效性校验，防止传入无效地址。

修正后的完整代码 #

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();

function onOpen() {
  var menu = [{name: "Send Wishes", functionName: "birthdayReminders"}];
  ss.addMenu("Birthday Wishes", menu); 
}

function birthdayReminders() {
  // 获取实际数据范围，避免遍历整列空行
  var dataRange = sheet.getDataRange();
  var data = dataRange.getValues();
  var sheetLength = data.length;
  
  // 提取各列数据（从第二行开始，第一行为表头）
  var emailAddresses = data.map(row => row[0]);
  var subjects = data.map(row => row[1]);
  var messages = data.map(row => row[2]);
  var birthdays = data.map(row => row[3]);
  var emailStatuses = data.map(row => row[4]);
  var birthdayImages = data.map(row => row[5]);
  
  var currentDate = new Date();
  // 格式化当前日期为MM/DD格式（可根据实际表格日期格式调整）
  var currentMonthDay = `${String(currentDate.getMonth()+1).padStart(2, '0')}/${String(currentDate.getDate()).padStart(2, '0')}`;
  
  var validImageUrls = [];
  // 预收集有效的图片URL
  for (var i = 1; i < sheetLength; i++) {
    var imgUrl = birthdayImages[i];
    if (imgUrl && typeof imgUrl === 'string' && imgUrl.trim() !== '') {
      validImageUrls.push(imgUrl.trim());
    }
  }
  
  var imageIndex = 0;
  var validImageCount = validImageUrls.length;

  try {
    for (var i = 1; i < sheetLength; i++) {
      var bday = birthdays[i];
      if (!bday) continue; // 跳过空生日行
      
      // 格式化生日的月日
      var bdayMonthDay = `${String(bday.getMonth()+1).padStart(2, '0')}/${String(bday.getDate()).padStart(2, '0')}`;
      
      var status = emailStatuses[i];
      if (bdayMonthDay === currentMonthDay && status !== "EMAIL_SENT") {
        var email = emailAddresses[i];
        var subject = subjects[i];
        var message = messages[i];
        
        // 校验邮箱有效性
        if (!email || typeof email !== 'string' || !email.includes('@')) {
          console.log(`无效邮箱，跳过行${i+1}: ${email}`);
          continue;
        }
        
        var imageLoad;
        var imgUrl = birthdayImages[i];
        // 优先使用当前行的图片URL，无效则使用预收集的备用图片
        if (imgUrl && typeof imgUrl === 'string' && imgUrl.trim() !== '') {
          try {
            imageLoad = UrlFetchApp.fetch(imgUrl.trim()).getBlob().setName("imageLoad");
          } catch (fetchErr) {
            console.log(`当前行图片加载失败，使用备用图片: ${fetchErr}`);
            imageLoad = getNextBackupImage();
          }
        } else {
          imageLoad = getNextBackupImage();
        }
        
        // 发送邮件
        MailApp.sendEmail(
          email,
          subject,
          "",
          {
            htmlBody: `${message}<BR><BR><img src='cid:nlFlag'><BR><BR>Thanks<BR>Hr Team<BR>LatentView`,
            inlineImages: { nlFlag: imageLoad }
          }
        );
        
        // 更新发送状态
        sheet.getRange(i+1, 5).setValue("EMAIL_SENT");
        SpreadsheetApp.flush();
      }
    }
  } catch (e) {
    MailApp.sendEmail("xxx@yyy.com", "Birthday Reminder-Delivery Failure", `Your automatic birthday reminder email failed to send email due to :${e}`);
    console.error(e);
  }
  
  // 获取下一张备用图片的辅助函数
  function getNextBackupImage() {
    if (validImageCount === 0) {
      throw new Error("无可用的备用图片URL");
    }
    var url = validImageUrls[imageIndex];
    imageIndex = (imageIndex + 1) % validImageCount;
    return UrlFetchApp.fetch(url).getBlob().setName("imageLoad");
  }
}

额外优化建议 #

• 在表格第一行添加表头（邮箱、主题、邮件内容、生日、发送状态、图片URL），确保数据结构清晰。
• 可设置定时触发器，代替手动点击菜单发送，实现完全自动化。
• 添加更多日志记录，便于后续排查问题。

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