Google Identity Services实现手动与自动登出功能问题咨询

问题根因说明 #

你遇到的gapi is not defined报错属于正常现象：新版Google Identity Services（GIS）已经完全废弃了旧版gapi.auth2相关接口，不需要加载旧版https://apis.google.com/js/platform.js，仅用你当前引入的https://accounts.google.com/gsi/client即可实现所有需求。

符合Google规范的实现方案 #

核心需求1：用户点击本站登出按钮主动终止当前站点Google会话 #

该实现完全不会影响用户全局Google账号（Gmail等其他服务不受影响），仅清除当前站点的Google登录关联缓存，下次登录必须重新选择账号/完成认证：

1. 登出按钮点击事件逻辑如下：

function siteLogout() {
    // 先清除站点自身的ASP.NET Forms认证Cookie
    document.cookie = "你的Forms认证Cookie名=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";

    // 调用GIS原生方法清除当前站点的Google登录缓存
    if (window.google?.accounts?.id) {
        // 关闭自动登录选择，清除站点级Google会话缓存
        google.accounts.id.disableAutoSelect();
        // 可选：重新渲染登录按钮恢复初始无账号状态
        google.accounts.id.initialize({
            client_id: "MYAPPIDPLACEHOLDER.apps.googleusercontent.com",
            callback: handleCredentialResponse,
            auto_select: false,
            ux_mode: "popup",
            context: "signin"
        });
        google.accounts.id.renderButton(
            document.querySelector(".g_id_signin"),
            {
                type: "standard",
                shape: "rectangular",
                theme: "outline",
                text: "signin_with",
                size: "large",
                logo_alignment: "left"
            }
        );
    }
    // 跳转回站点登录页
    window.location.href = "https://www.example.com/login";
}

核心需求2：闲置60分钟自动失效Google登录会话 #

直接在你现有站点的闲置超时触发逻辑中，调用上述siteLogout()方法即可，同时完成站点自身认证失效和Google站点级会话清除。

过往方案疑问解答 #

方案1疑问解答 #

• 旧方案使用platform.js是因为网上大量教程未同步更新，该旧版SDK已被Google官方标记为废弃，不推荐继续使用。
• 旧版signOut()执行后仍可免密登录属于Google默认设计：旧版方法仅清除站点内的gapi会话缓存，不会关闭自动登录逻辑，浏览器只要有活跃的Google账号会话，就会自动返回认证凭证完成登录。

方案2疑问解答 #

• 无痕模式的跳转确认是Google内置的安全机制，用于防止恶意站点强制登出用户全局账号，无取消方式。
• 跳转到公司SSO页是企业Google Workspace的全局配置，由公司IT侧设置，第三方站点无法修改。
• 全局登出Google账号的方案本身不符合OAuth2设计规范，OAuth的核心原则就是禁止第三方站点干涉用户的全局账号状态，完全不推荐使用。

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