Google Apps Script返回数据前端接收为null，无法渲染HTML表格求助

算力阿峰

2026-7-21

排查Google Apps Script前端接收后端数据为null的问题

以下是针对性的排查步骤：

确认后端返回值可序列化：google.script.run仅支持传递可序列化的数据（数组、普通对象、字符串、数字等），如果getAllPatientsList()返回的是Spreadsheet Range、Blob这类Google服务对象，前端会接收null。确保函数返回纯数据结构，比如：
```
function getAllPatientsList() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Patients');
  return sheet.getDataRange().getValues(); // 返回二维数组而非Range对象
}
```
核对函数名拼写：google.script.run对函数名大小写敏感，前端调用的函数名必须和后端完全一致，比如后端是getAllPatientsList()，前端不能写成getAllpatientList()或其他变体。
添加错误捕获排查：在前端调用时增加失败处理函数，直接查看控制台错误信息：
```
google.script.run
  .withSuccessHandler(displayPatients)
  .withFailureHandler(err => console.error('调用失败:', err))
  .getAllPatientsList();
```
控制台会输出具体错误，比如函数不存在、权限不足、序列化失败等。

检查后端函数隐性异常：即使服务器日志显示有数据，也要确认函数没有被吞掉的异常。比如如果函数包含try-catch块，需确保异常被抛出或正确处理，避免函数返回undefined（前端接收为null）：

function getAllPatientsList() {
  try {
    const data = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Patients').getDataRange().getValues();
    console.log(data);
    return data;
  } catch(e) {
    console.error(e);
    throw e; // 抛出异常，让前端failureHandler捕获
  }
}