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

页面刷新后恢复用户状态

页面刷新后恢复用户状态

前端页面刷新后,内存里的用户对象会消失,但浏览器保存的 Token 可能仍然有效。本节把“本地有 Token”与“服务端仍认可会话”分开处理:启动时携带 Token 请求当前用户接口,只有后端确认成功后才恢复登录态。

学习目标

  • 理解页面刷新后为什么不能只凭本地 Token 判定已登录
  • 使用 Sa-Token 的登录校验接口确认会话仍然有效
  • 在应用启动阶段重新获取当前用户并恢复前端状态

刷新真正丢失的是什么

刷新页面时,组件状态、状态管理仓库等内存数据会被重建;localStorage 中的 Token 通常不会因此消失。因此“Token 还在”只能说明浏览器保存过凭据,不能证明它没有过期、被注销或被踢下线。

正确的启动流程是:先读取 Token,再访问一个必须登录才能成功的 /api/auth/me 接口;接口成功就用返回的用户资料重建前端状态,返回 401 就清理失效 Token 并按未登录状态继续。

页面刷新后恢复认证状态的请求流程

用后端接口重新确认会话

后端的“当前用户”接口必须以服务端会话状态为准。下面是片段示例,假定项目已有 UserService 与 UserProfile,并在统一异常处理中把 NotLoginException 转成 HTTP 401。

java
@GetMapping("/api/auth/me")
public UserProfile currentUser() {
    // Token 无效、过期或会话已失效时会抛出 NotLoginException。
    StpUtil.checkLogin();

    long userId = StpUtil.getLoginIdAsLong();
    return userService.findProfile(userId);
}

接口成功时返回当前登录账号的最新资料;如果昵称、角色或权限刚被修改,刷新后也能拿到服务端的当前值,而不是继续使用旧的前端缓存。

在应用启动时恢复状态

下面示例使用 Axios。项目需要已安装 axios,并约定 Sa-Token 的请求头名称为 satoken;如果后端修改了 token-name,前端必须使用相同名称。

ts
import axios from 'axios';

type User = {
  id: number;
  username: string;
};

const TOKEN_KEY = 'satoken';

const api = axios.create({
  baseURL: '/api'
});

api.interceptors.request.use((config) => {
  const token = localStorage.getItem(TOKEN_KEY);
  if (token) {
    // Axios 1.x 的 headers 支持 set,用同一个入口统一附加 Token。
    config.headers.set('satoken', token);
  }
  return config;
});

export async function restoreAuth(): Promise<User | null> {
  const token = localStorage.getItem(TOKEN_KEY);
  if (!token) {
    return null;
  }

  try {
    const { data } = await api.get<User>('/auth/me');
    console.log(`restored:${data.id}`);
    return data;
  } catch (error) {
    if (axios.isAxiosError(error) && error.response?.status === 401) {
      localStorage.removeItem(TOKEN_KEY);
      console.log('anonymous');
      return null;
    }
    throw error;
  }
}

预期输出:Token 仍有效时,控制台中的账号 ID 会因实际用户而不同。

text
restored:<ID>

Token 已失效时:

text
anonymous

应用入口应在首次渲染受保护页面前调用 restoreAuth(),再把返回的用户写入 Pinia、Redux 或其他状态容器。这样可以避免页面先按“已登录”渲染,随后又因为接口失败突然跳回游客状态。

避免两个常见误区

不要把 localStorage.getItem('satoken') !== null 当作登录判断,它只能判断本地是否保存了字符串。也不要在刷新时直接恢复旧的用户 JSON,因为用户资料、角色和权限都可能已经在服务端变化。

如果应用允许多个标签页同时退出登录,还可以在认证状态稳定后再补充 storage 事件同步;但页面刷新恢复的核心始终只有一条:以服务端对当前 Token 的校验结果重新建立前端状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

页面刷新后恢复用户状态

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

登录哪都通