Google Apps Script中window.top.location.href重定向失效问题

这是Google Apps Script 2024年上半年安全策略更新引发的普遍问题，大量开发者都反馈过同类故障。

失效原因 #

• GAS Web App返回的HTML内容默认嵌套在*.googleusercontent.com域名的多层iframe中，此前平台默认给iframe开放了allow-top-navigation权限，允许子iframe脚本修改顶层窗口地址。近期平台收紧了沙箱规则，未显式配置权限的iframe默认禁止操作top上下文，因此window.top.location.href赋值会被浏览器安全规则拦截，开发者工具的控制台中可看到对应的跨上下文导航拦截报错。

修复方案 #

方案1：显式开放iframe顶部导航权限 #

给返回的HtmlOutput对象添加沙箱配置和内容安全策略声明，重新启用顶部导航权限，不需要修改原有跳转逻辑，90%以上的场景下可直接恢复原有跳转效果：

return HtmlService.createHtmlOutput(`<script>window.top.location.href='${url}';</script>`)
  .setSandboxMode(HtmlService.SandboxMode.IFRAME)
  .addMetaTag('Content-Security-Policy', "allow-top-navigation 'self' *;");

方案2：添加降级跳转兜底 #

如果方案1仍不生效（部分企业域管理员限制了GAS的iframe权限），可以添加用户主动触发的跳转兜底，用户交互触发的顶层导航不受沙箱规则限制：

return HtmlService.createHtmlOutput(`
<p id="tip" style="display:none">页面跳转中，如果没有自动跳转请<a href="${url}" target="_top">点击这里</a></p>
<script>
setTimeout(() => {
  try {
    window.top.location.href = '${url}';
  } catch (err) {
    document.getElementById('tip').style.display = 'block';
  }
}, 300);
</script>
`)

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