Google Apps Script报Argument cannot be null:findtext错误求助

报错信息：Argument Cannot be null :findtext

根因定位 #

报错直接触发原因是createTextFinder()方法接收到的检索关键词参数为null/undefined，和你在服务端手动传有效值调用GetArray()的测试场景不一致，前端通过google.script.run调用时实际没有传入有效的用户编码参数，具体问题点如下：

• 后端渲染传参缺失：登录成功后渲染Table页面时，render方法仅传了array/round/time三个参数，没有把当前登录的usercode传给前端模板，导致前端拿不到有效用户编码。
• 前端取值逻辑无校验：DOM加载完成后直接取loginuser元素的value，既没有判断元素是否存在，也没有判断值是否为空，一旦元素不存在/value为空，就会把空值传给服务端函数。
• 范围计算存在潜在bug：GetTimeTable中调用ScanSheet.getRange(5, 2, lastrow, 5)时，第三个参数为选取行数，直接传入整表最后一行行号会导致选取范围超出表格实际边界（从第5行开始选lastrow行，最终行号会超过表格最大行）。
• 缺少空值防护：两个业务函数中调用findNext()后都没有做判空处理，一旦表格中找不到匹配的用户编码，会直接触发空指针报错，没有明确错误提示。

修正方案 #

1. 首先在代码开头全局初始化表格变量，避免未定义问题：

// 替换成你自己表格对应的实际名称
const ss = SpreadsheetApp.getActiveSpreadsheet();
const PayrollSheet = ss.getSheetByName("Payroll");
const ScanSheet = ss.getSheetByName("Scan");

2. 修改doPost逻辑，渲染Table页面时把usercode传给模板：

if (username != 'FALSE') {
  ////// 登录成功逻辑
  var r = GetRound();
  var a = GetArray(usercode);
  // 新增传入usercode参数
  return render('Table', { array: a, round: r, time: t, usercode: usercode });
}

3. 重构GetTimeTable方法，加入参校验、修正范围计算、增加匹配结果判空：

function GetTimeTable(Usercode) {
  // 入参为空直接抛出明确错误
  if (typeof Usercode !== 'string' || Usercode.trim() === '') {
    throw new Error("用户编码参数不能为空");
  }
  const lastrow = ScanSheet.getLastRow();
  // 修正范围：从第5行第2列开始，选(lastrow - 4)行5列，刚好覆盖到表尾
  const searchRange = ScanSheet.getRange(5, 2, lastrow - 4, 5);
  const matchCell = searchRange.createTextFinder(Usercode.trim()).findNext();
  if (!matchCell) {
    throw new Error(`扫描表中未找到用户编码【${Usercode}】的匹配记录`);
  }
  const matchRow = matchCell.getRow();
  return ScanSheet.getRange(matchRow, 2, 5, 18).getDisplayValues();
}

4. 前端Table模板中加入隐藏域存储后端传入的usercode：

<!-- 放在Table页面的DOM结构中，用模板语法输出后端传值 -->
<input type="hidden" id="loginuser" value="<?= usercode ?>">

5. 修改前端JS逻辑，增加取值校验和失败回调：

document.addEventListener("DOMContentLoaded",function(){    
  const userInput = document.getElementById("loginuser");
  if (!userInput) {
    console.error("页面缺少用户编码存储节点，请重新登录");
    location.href = "/";
    return;
  }
  const loginuser = userInput.value.trim();
  if (!loginuser) {
    console.error("用户编码为空，请重新登录");
    location.href = "/";
    return;
  }
  google.script.run
    .withSuccessHandler(generateTable)
    .withFailureHandler(err => {
      console.error("查询课表失败：", err.message);
      alert("查询失败：" + err.message);
    })
    .GetTimeTable(loginuser);    
});

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