Google Apps Script匹配PO号前3位获取对应邮箱地址问题排查

1 核心错误：every()方法使用不符合预期 #

Array.prototype.every()的遍历规则是：仅当所有元素的回调函数都返回真值时才会返回true，只要某一轮回调返回假值（包括未显式写return时默认返回的undefined），就会立刻终止整个遍历流程，不会继续检查后面的元素。
你的代码中只有匹配到目标PO前缀时才会return false，未匹配到的场景没有任何返回值，默认返回的undefined属于假值，所以大概率第一个PO号不匹配时遍历就直接停止，根本不会走到匹配项。

2 其他可能导致匹配失败的问题 #

• 大小写不一致：PO号前缀如果带字母，可能出现大小写差异，比如ABC和abc会被判定为不相等
• 隐形空格问题：提取的字符串前后可能带有看不见的空格、换行符，导致匹配失败
• 空值提前终止：getRange("A2:A")会拉取表格最大行范围内的所有空单元格，空值提取前三位后是空字符串，未匹配时同样会返回undefined提前终止遍历

3 修复后的代码 #

function main() {
  var ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Purchase Orders List");
  // 提取目标PO前3位，同时做去空格、转大写处理，避免匹配误差
  var po_numID = ss.getRange("A2").getDisplayValue().trim().substr(0, 3).toUpperCase();
  Logger.log("待匹配PO前缀：" + po_numID)
  var emailDataSheet = SpreadsheetApp.openByUrl("https://docs.google.com/spreadsheets/d/1xIA3xcXrpjCPO8r3rzXuVWhu-ycUkN1iQzfYbpFFlFM/edit#gid=1768035929").getSheetByName("TestA");
  
  // 一次性拉取整张表的所有数据，避免循环调用接口，提升性能
  var allRows = emailDataSheet.getDataRange().getDisplayValues();
  // 从索引1开始遍历，跳过表头行
  for(var i = 1; i < allRows.length; i++) {
    var currentPoPrefix = allRows[i][0].trim().substr(0,3).toUpperCase();
    if(currentPoPrefix === po_numID) {
      var email = allRows[i][6]; // G列对应数组索引为6（A列索引为0）
      Logger.log("匹配到的邮箱：" + email);
      // 如果只需要取第一个匹配结果，加break直接终止循环即可
      break;
    }
  }
}

4 残留问题排查步骤 #

如果修改后仍无匹配结果，按以下顺序验证：

1. 查看日志输出的po_numID是否符合预期，确认是A2单元格PO号的前三位
2. 打印TestA表所有PO号的前三位，人工核对是否存在和po_numID完全一致的项
3. 确认当前运行脚本的谷歌账号，拥有TestA对应表格的查看权限，权限不足会导致拉取的数据为空

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