身份认证与应用安全 / 系统课时
主动退出当前登录状态
主动退出当前登录状态
退出登录不只是把页面跳回登录页,而是要让当前 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()。
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,应按实际配置调整。
curl -X POST "http://localhost:<PORT>/auth/logout" \
-H "satoken: <TOKEN>"其中 <PORT> 和 <TOKEN> 分别替换为实际服务端口与当前登录 Token。
预期输出
{"loggedIn":false}返回 false 表明当前登录上下文已经退出。之后继续使用同一个旧 Token 访问执行了登录校验的接口时,应进入项目配置的未登录处理流程;具体 HTTP 状态码和响应体取决于项目自己的异常处理方式。
同步清理客户端认证信息
服务端退出成功后,前端还要删除自己实际保存的那份凭证。关键不是“把所有地方都删一遍”,而是先确认系统采用哪种 Token 传递方式。
如果 Token 存在 localStorage,应删除对应键;存在 sessionStorage 时同样清理当前会话中的键。如果使用普通 Cookie,可以按照创建 Cookie 时一致的名称、Path 等属性删除。
如果认证 Cookie 设置了 HttpOnly,浏览器 JavaScript 无法直接删除它,此时应由服务端通过响应 Cookie 的过期机制完成清理。不要为了方便退出而取消 HttpOnly,否则会削弱 Cookie 对脚本读取的防护能力。
验证退出链路
完整验证至少包含两个观察点:调用退出接口后,当前登录检查应为未登录;浏览器本地也不应继续保存并发送旧 Token。随后重新访问需要认证的接口,应触发未登录响应,而不是继续取得原账号的数据。
这样处理后,退出动作同时关闭了服务端登录状态和客户端凭证入口,页面状态与真实认证状态才能保持一致。