Google Apps Script获取多行表格数据时withSuccessHandler返回null求助

问题原因 #

当你调用getValues()获取包含公式错误值（比如#N/A、#DIV/0!、#VALUE!等）的单元格范围时，这些错误值会以特殊对象的形式存在，而google.script.run无法将这类对象序列化为JSON格式，最终导致客户端接收到的返回值为null。单行数据时刚好没碰到错误值，所以能正常返回；多行时包含了错误值，就触发了这个问题。

解决方案 #

方案1：获取单元格显示文本（简单直接） #

改用getDisplayValues()替代getValues()，它会返回单元格的显示文本（包括错误值的文本内容），避免序列化问题：

// Code.gs 中的 update 函数修改为
function update() {
  return SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange(1, 1, 2, 2).getDisplayValues();
}

方案2：过滤/替换错误值（保留原始有效数据） #

如果需要保留正常单元格的原始值（比如数字、文本），只处理错误值，可以遍历数组替换错误对象：

// Code.gs 中的 update 函数修改为
function update() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const values = sheet.getRange(1, 1, 2, 2).getValues();
  
  // 遍历二维数组，将错误值替换为空字符串（可根据需求改成null或其他默认值）
  return values.map(row => 
    row.map(cell => {
      // 判断是否为Spreadsheet错误对象
      if (typeof cell === 'object' && cell !== null && cell.error) {
        return '';
      }
      return cell;
    })
  );
}

额外建议：增加错误捕获 #

在客户端代码中添加错误处理函数，方便排查问题：

<!-- WebAppChart.html 中的 script 修改为 -->
<script>
  function update() {
    google.script.run
      .withSuccessHandler(function(ar) {
        console.log(ar);
      })
      .withFailureHandler(function(error) {
        console.error('数据获取失败:', error); // 打印错误信息，帮助排查
      })
      .update();
  }
</script>

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