在 Google Apps Script 的 Web App 或 Sidebar 环境中，window.location.href 和 top.location 等跳转方式因沙盒（sandbox）限制而失效，需改用 google.script.host.close() 配合服务端重定向或客户端页面刷新策略。
在 google apps script 的 web app 或 sidebar 环境中，`window.location.href` 和 `top.location` 等跳转方式因沙盒（sandbox）限制而失效，需改用 `google.script.host.close()` 配合服务端重定向或客户端页面刷新策略。
Google Apps Script 的 HTML 服务（HtmlService）默认以 形式嵌入（如 Sheets 侧边栏或模态对话框），受浏览器同源策略与 GAS 沙盒机制双重约束——window.top.location、window.location.replace() 等直接跳转行为被明确禁止，调用后无响应或报错 Unsafe JavaScript attempt to initiate navigation。
✅ 正确的重定向实践
1. 登录成功后：关闭当前界面 + 触发服务端重载
你的 login.html 中已正确使用 google.script.host.close()，但关键在于：关闭后需由客户端主动触发新页面加载，而非依赖服务端返回重定向响应。修改 loginSuccess 函数如下：
function loginSuccess(isAuthenticated) {
if (isAuthenticated) {
// 先关闭登录弹窗/侧边栏
google.script.host.close();
// 再通过客户端跳转到主页面（注意：必须是同一 Web App 的有效路径）
setTimeout(() => {
window.location.href = ScriptApp.getService().getUrl() + '?app=main';
}, 300);
} else {
alert("Kullanıcı adı veya şifre hatalı. Tekrar deneyin.");
}
}
⚠️ 注意：
ScriptApp.getService().getUrl()仅在已部署为 Web App 时有效；若用于 Sheets 侧边栏（showSidebar()），则应改用google.script.run.openMainPage()（见下文）。
2. 登出后：清除状态 + 刷新或跳转回登录页
你当前 logoutUser() 返回的 <script></script> 标签在沙盒中完全无效（GAS 会剥离内联脚本）。应改为纯客户端处理：
✅ 修改 main.html 中的 logout() 函数：
通过 Gemini 搜索落地（主）和 Custom Search JSON API（备）进行 Google 网页搜索。用途：(1) 附引用的综合回答（落地搜索），(2) 含摘要的原始链接结果，(3) 图片搜索。希伯来语支持极佳。优于内置 web_search (Perplexity)。
function logout() {
google.script.run.withSuccessHandler(() => {
// 服务端已清除登录状态，客户端立即刷新页面
window.location.href = ScriptApp.getService().getUrl(); // Web App 场景
// 或：google.script.run.openLogin(); // 若定义了对应服务端函数
}).logoutUser();
}
✅ 同时，在 code.gs 中移除无效的 HTML 返回，仅执行状态清理：
function logoutUser() {
PropertiesService.getUserProperties().deleteProperty('loggedIn');
// 不返回 HtmlOutput！避免混淆执行上下文
}
3. 增强健壮性：统一入口路由（推荐）
为避免硬编码 URL，可在 doGet() 中支持参数路由，并让客户端始终跳转至 /：
function doGet(e) {
const userProps = PropertiesService.getUserProperties();
const isLoggedIn = userProps.getProperty('loggedIn') === 'true';
// 支持 ?page=login 或 ?page=main（可选）
if (e.parameter.page === 'login' || !isLoggedIn) {
return HtmlService.createTemplateFromFile('login').evaluate()
.setTitle('Oturum Aç')
.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);
} else {
return HtmlService.createTemplateFromFile('main').evaluate()
.setTitle('Ana Sayfa')
.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);
}
}
此时客户端跳转统一使用：
// 登录成功后 window.location.href = ScriptApp.getService().getUrl(); // 登出后（同上） window.location.href = ScriptApp.getService().getUrl();
? 重要注意事项
- ❌ 禁止在 HTML 中使用
window.top.location、document.write()、等绕过沙盒的尝试； - ✅ 所有导航逻辑必须由
window.location.href（客户端）或google.script.host.close()（关闭后由宿主容器控制）完成； - ? 若部署为 Web App，确保发布权限设为 “Anyone with the link” 或 “Anyone in your organization”，否则重定向将因 401 错误中断；
- ? 密码明文存储（如示例中
user表）存在严重安全风险，生产环境务必改用PropertiesService.getScriptProperties()存储哈希凭证，或集成 Google Identity Service。
通过以上调整，即可在符合 GAS 安全规范的前提下，实现平滑、可靠的页面导航体验。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
