Google Sheet数据更新后Web App API返回旧数据问题求助

核心原因 #

Google Apps Script部署的Web App默认开启响应缓存机制，即便脚本已获取到Sheet最新数据，客户端浏览器或Google的CDN仍会返回缓存的旧内容。

解决方案 #

1. 在响应中添加禁用缓存的HTTP头 #

修改doGet函数的返回逻辑，通过setHeaders方法添加缓存控制头，强制跳过所有缓存环节：

function doGet() {
  var standingsSheet = SpreadsheetApp.openById("1kpNP-MufnJkT7Fydh71B6NNA5TC4prnTNi9U23a9UuY");
  var standingsValues = standingsSheet.getActiveSheet().getDataRange().getValues();

  var league1 = getLeaguesStandings(2, standingsValues);
  var league2 = getLeaguesStandings(31, standingsValues);
  var league3 = getLeaguesStandings(60, standingsValues);
  var league4 = getLeaguesStandings(87, standingsValues);
  var league5 = getLeaguesStandings(116, standingsValues);
  var output = [];
  output.push(league1);
  output.push(league2);
  output.push(league3);
  output.push(league4);
  output.push(league5);

  // 添加缓存控制头，彻底禁用缓存
  return ContentService.createTextOutput(JSON.stringify({ data: output }))
    .setMimeType(ContentService.MimeType.JSON)
    .setHeaders({
      "Cache-Control": "no-cache, no-store, must-revalidate",
      "Pragma": "no-cache",
      "Expires": "0"
    });
}

2. 重新部署时创建新版本 #

每次修改脚本后，重新部署Web App必须选择新建版本，而非仅更新现有版本：

• 点击脚本编辑器右上角「部署」→「部署为Web应用」
• 在版本下拉框选择「新建」，填写版本说明（如v2）
• 确认「执行权限」和「访问权限」设置无误后，点击「部署」
• 使用新生成的Web App链接进行调用

3. 客户端请求添加随机参数（备选方案） #

若无法修改脚本，可在API请求URL末尾添加随机参数（如时间戳），强制浏览器绕过本地缓存：

https://script.google.com/macros/s/你的WebAppID/exec?rand=1699999999

额外检查点 #

• 测试时使用无痕/匿名窗口，避免浏览器本地缓存干扰结果
• 若Sheet存在多个标签页，建议将getActiveSheet()改为getSheetByName("目标工作表名称")，确保读取的是正确的数据源

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