身份认证与应用安全 / 系统课时

主动退出当前登录状态

主动退出当前登录状态

退出登录不只是把页面跳回登录页,而是要让当前 Sa-Token 登录凭证真正失效,并同步清理客户端保存的认证信息。本节通过 StpUtil.logout() 完成服务端退出,再明确前端在 Header、Storage 或 Cookie 场景下需要处理的内容。

学习目标

  • 使用 StpUtil.logout() 结束当前请求对应的登录状态
  • 验证退出后当前 Token 已不能继续代表登录用户
  • 正确清理浏览器端保存的 Token,避免残留凭证造成状态错乱

退出的是当前登录凭证

用户主动点击“退出登录”时,服务端应根据当前请求携带的 Token 找到对应登录状态,并执行 StpUtil.logout()。这种操作针对当前登录上下文,适合个人中心退出、切换账号等正常结束会话的场景。

不要只让前端删除 Token。仅删除浏览器里的值虽然会让当前页面看起来已经退出,但服务端保存的登录状态可能仍然有效;如果旧 Token 被其他地方持有,它仍可能继续访问系统。

反过来也不能只调用服务端退出而保留浏览器 Token。这样浏览器之后仍会反复发送一个已经失效的凭证,容易出现页面显示已登录、接口却持续提示未登录的状态不一致。

调用 logout

下面是一个 Spring Boot 控制器片段。它依赖项目已经完成 Sa-Token 与 Spring Boot 的集成,因此属于片段示例;核心逻辑只有当前请求上下文中的 StpUtil.logout()。

java
package com.example.auth;

import cn.dev33.satoken.stp.StpUtil;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Map;

@RestController
@RequestMapping("/auth")
public class AuthController {

    @PostMapping("/logout")
    public Map<String, Boolean> logout() {
        // 让当前请求所携带的登录凭证结束登录状态。
        StpUtil.logout();

        // 同一请求中再次检查,可用于演示退出是否已经生效。
        return Map.of("loggedIn", StpUtil.isLogin());
    }
}

假设项目使用默认 Token 名 satoken,并通过请求头传递 Token,可以这样调用;如果项目修改了 token-name 或采用 Cookie,应按实际配置调整。

bash
curl -X POST "http://localhost:<PORT>/auth/logout" \
  -H "satoken: <TOKEN>"

其中 <PORT> 和 <TOKEN> 分别替换为实际服务端口与当前登录 Token。

预期输出

json
{"loggedIn":false}

返回 false 表明当前登录上下文已经退出。之后继续使用同一个旧 Token 访问执行了登录校验的接口时,应进入项目配置的未登录处理流程;具体 HTTP 状态码和响应体取决于项目自己的异常处理方式。

同步清理客户端认证信息

服务端退出成功后,前端还要删除自己实际保存的那份凭证。关键不是“把所有地方都删一遍”,而是先确认系统采用哪种 Token 传递方式。

如果 Token 存在 localStorage,应删除对应键;存在 sessionStorage 时同样清理当前会话中的键。如果使用普通 Cookie,可以按照创建 Cookie 时一致的名称、Path 等属性删除。

如果认证 Cookie 设置了 HttpOnly,浏览器 JavaScript 无法直接删除它,此时应由服务端通过响应 Cookie 的过期机制完成清理。不要为了方便退出而取消 HttpOnly,否则会削弱 Cookie 对脚本读取的防护能力。

验证退出链路

完整验证至少包含两个观察点:调用退出接口后,当前登录检查应为未登录;浏览器本地也不应继续保存并发送旧 Token。随后重新访问需要认证的接口,应触发未登录响应,而不是继续取得原账号的数据。

这样处理后,退出动作同时关闭了服务端登录状态和客户端凭证入口,页面状态与真实认证状态才能保持一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

主动退出当前登录状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通