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

登录失效后统一回到登录页

登录失效后统一回到登录页

Token 过期、主动注销或被服务端踢下线后,任意受保护接口都可能首先暴露失效状态。本节把处理集中到 Axios 响应拦截层:识别统一的未登录响应、清理认证数据,并只执行一次跳转,避免每个页面重复处理。

学习目标

  • 为登录失效定义稳定的前后端响应契约
  • 在响应拦截器中统一清理 Token 与用户状态
  • 处理并发 401、登录接口本身失败和重复跳转等边界

先统一登录失效的响应契约

前端不应该通过“请重新登录”之类的文案判断会话是否失效。更稳妥的做法是让后端把 Sa-Token 的 NotLoginException 统一映射成 HTTP 401,并返回固定业务码,例如 NOT_LOGIN。

下面是 Spring Boot 片段示例,可放入项目现有的全局异常处理类中。

java
@ExceptionHandler(NotLoginException.class)
@ResponseStatus(HttpStatus.UNAUTHORIZED)
public Map<String, Object> handleNotLogin(NotLoginException exception) {
    return Map.of(
        "code", "NOT_LOGIN",
        "message", "登录状态已失效"
    );
}

生效行为:任意受保护接口触发未登录异常时,前端都能依赖 401 与 NOT_LOGIN 这一稳定契约处理,而不需要识别 Sa-Token 的异常文案。

把失效处理集中到响应拦截器

多个请求可能在同一时刻发现 Token 已失效,例如页面并发加载用户信息、菜单和业务数据。如果每个失败请求都执行一次跳转,就会出现重复导航和重复提示,因此拦截器还需要一个“正在跳转”保护。

登录失效后的统一处理流程

下面示例使用 Axios,并用一个简单对象代表内存认证状态。真实项目可以把 authState.user = null 替换成 Pinia、Redux 或其他状态管理调用。

ts
import axios from 'axios';

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

type ErrorBody = {
  code?: string;
  message?: string;
};

const TOKEN_KEY = 'satoken';
export const authState: { user: User | null } = { user: null };

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

let redirectingToLogin = false;

api.interceptors.response.use(
  (response) => response,
  (error) => {
    if (!axios.isAxiosError<ErrorBody>(error)) {
      return Promise.reject(error);
    }

    const status = error.response?.status;
    const code = error.response?.data?.code;
    const isLoginRequest = error.config?.url === '/auth/login';
    const loginExpired = status === 401 && code === 'NOT_LOGIN';

    if (loginExpired && !isLoginRequest && !redirectingToLogin) {
      redirectingToLogin = true;

      // 持久化凭据与内存用户状态必须一起清理。
      localStorage.removeItem(TOKEN_KEY);
      authState.user = null;

      const current = window.location.pathname
        + window.location.search
        + window.location.hash;
      const redirect = encodeURIComponent(current);

      console.log('redirect:/login');
      window.location.replace(`/login?redirect=${redirect}`);
    }

    return Promise.reject(error);
  }
);

预期输出:当受保护接口返回约定的 401 + NOT_LOGIN 时,控制台只记录一次跳转;随后浏览器进入登录页。

text
redirect:/login

登录页与并发请求的边界

登录接口输入错误时也可能使用 401。因此示例明确排除了 /auth/login,避免“密码错误”直接触发全局回登录页逻辑。若你的后端把登录失败设计成其他状态码,也应保持契约一致,而不是让前端猜测。

并发请求触发多个 401 时,redirectingToLogin 保证当前页面只发起一次导航。使用 location.replace() 而不是 location.href,还能避免用户按浏览器返回键再次回到已经失效的受保护页面。

跳转后如何回到原页面

示例把失效前的站内路径放进 redirect 查询参数。登录成功后,可以读取这个参数并导航回原页面;同时必须只接受站内相对路径,不能直接信任任意外部 URL,避免把登录流程变成开放重定向入口。

统一拦截的价值不只是少写几段代码,而是让“登录失效”成为一条确定的系统行为:后端统一发出未登录信号,前端统一清理状态并进入登录流程,业务页面不再各自维护一套失效处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

登录失效后统一回到登录页

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

登录哪都通