使用Google Apps Script开发谷歌表格侧边栏显示单元格值遇HTTP502错误

1 服务端代码排查要点 #

• 确认getRecord函数在.gs脚本文件中全局定义，未嵌套在其他函数内部，否则前端无法通过google.script.run调用
• 检查单元格读取逻辑是否存在范围越界：如果当前表格不足10行，调用getRange读取第10行时会抛出无效范围错误，触发502响应
• 不要在getRecord函数内调用SpreadsheetApp.getUi()类的界面接口，前端触发的服务端函数无法访问表格UI组件，执行会直接报错

2 参考服务端代码 #

可直接替换你的getRecord函数逻辑：

function getRecord() {
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 获取当前选中单元格的列号
  const currentCol = SpreadsheetApp.getActiveRange().getColumn();
  // 读取同列第1、6、10行的显示值
  const row1Val = activeSheet.getRange(1, currentCol).getDisplayValue();
  const row6Val = activeSheet.getRange(6, currentCol).getDisplayValue();
  const row10Val = activeSheet.getRange(10, currentCol).getDisplayValue();
  return {
    row1: row1Val,
    row6: row6Val,
    row10: row10Val
  };
}

3 前端调用代码优化 #

调用google.script.run时必须添加错误捕获逻辑，方便定位具体问题：

// 侧边栏更新触发函数
function loadColData() {
  google.script.run
    .withFailureHandler((err) => {
      // 控制台打印详细错误信息，可按F12打开开发者工具查看
      console.error('服务端调用错误', err);
      alert('数据加载失败：' + err.toString());
    })
    .withSuccessHandler((res) => {
      // 将返回值渲染到侧边栏节点
      document.querySelector('#row1').innerText = res.row1;
      document.querySelector('#row6').innerText = res.row6;
      document.querySelector('#row10').innerText = res.row10;
    })
    .getRecord();
}

4 调试注意事项 #

• 每次修改.gs服务端代码后，必须刷新整个谷歌表格页面，再重新打开侧边栏测试，避免旧代码缓存导致持续报错
• 确认脚本运行的谷歌账号拥有当前表格所有单元格的读取权限，受保护范围的权限限制也会触发服务端执行错误

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