Vue / 系统课时

管理访问令牌

管理访问令牌

登录接口返回访问令牌后,前端需要用统一方式保存、读取和清理它。本课将封装一个可切换存储策略的令牌模块,并说明内存、sessionStorage 与 localStorage 在安全性、刷新恢复和使用体验上的差异。

学习目标

  • 封装访问令牌的保存、获取和清理接口
  • 根据会话需求选择内存、会话存储或本地存储
  • 避免令牌残留、空值写入和多处直接操作存储

先确定存储策略

访问令牌放在哪里,决定了页面刷新后是否仍保持登录,也影响令牌被脚本读取的风险。三种常见方案没有绝对优劣,应按业务场景选择。

方案 页面刷新后 关闭标签页后 适用场景
内存变量 丢失 丢失 高敏感后台、可静默续期的应用
sessionStorage 保留 通常清除 希望单次浏览器会话保持登录
localStorage 保留 保留 需要长期登录且能接受更高风险

以上三种方案都可能被同源恶意脚本读取,因此不能用它们替代 XSS 防护。若后端支持基于 HttpOnly Cookie 的安全会话,应优先评估由服务端管理刷新凭据。

封装令牌工具

下面的模块通过环境变量选择存储方式。业务代码只调用统一函数,不再直接读写浏览器存储,这样以后更换方案时不需要修改登录页、请求拦截器和退出逻辑。

ts
// src/utils/token.ts
type TokenStorageMode = 'memory' | 'session' | 'local'

const TOKEN_KEY = 'admin_access_token'
const mode = (import.meta.env.VITE_TOKEN_STORAGE ?? 'session') as TokenStorageMode

let memoryToken: string | null = null

function resolveStorage(): Storage | null {
  if (mode === 'local') return window.localStorage
  if (mode === 'session') return window.sessionStorage
  return null
}

export function saveAccessToken(token: string): void {
  const normalized = token.trim()
  if (!normalized) {
    throw new Error('Access token cannot be empty')
  }

  const storage = resolveStorage()
  if (storage) {
    storage.setItem(TOKEN_KEY, normalized)
  } else {
    memoryToken = normalized
  }
}

export function getAccessToken(): string | null {
  const storage = resolveStorage()
  return storage ? storage.getItem(TOKEN_KEY) : memoryToken
}

export function clearAccessToken(): void {
  const storage = resolveStorage()
  if (storage) {
    storage.removeItem(TOKEN_KEY)
  }
  memoryToken = null
}

这是项目模块示例,依赖 Vite 浏览器环境。创建 .env.development 并选择会话级存储:

bash
printf 'VITE_TOKEN_STORAGE=session\n' > .env.development

预期结果:

text
开发环境启动后,令牌写入 sessionStorage;刷新页面仍可读取,关闭当前标签页后会话数据被清除。

修改环境变量后需要重新启动开发服务器,因为 Vite 在启动时加载环境配置。

接入登录与退出流程

登录成功时只保存后端明确返回的访问令牌;退出登录、令牌失效或用户切换账号时统一调用 clearAccessToken()。请求拦截器也只通过 getAccessToken() 获取值,避免不同模块使用不同键名或不同存储位置。

ts
// 片段示例:依赖已实现的 loginApi 和路由实例
import { clearAccessToken, saveAccessToken } from '@/utils/token'

const response = await loginApi(form)
saveAccessToken(response.accessToken)

async function logout(): Promise<void> {
  clearAccessToken()
  await router.replace('/login')
}

预期结果:

text
登录成功后后续请求可读取令牌;执行退出后令牌被删除,并跳转到 /login。

不要把完整用户对象、权限列表和令牌重复存入多个位置。令牌负责认证,用户资料与权限状态应由独立状态模块管理,并在退出时一起重置。

验证与常见问题

打开浏览器开发者工具,在 Application 或 Storage 面板检查对应存储项。使用内存模式时面板中不会出现令牌,这是正常现象;刷新页面后登录状态也会丢失。

若读取结果始终为 null,先确认保存和读取是否使用同一运行环境,再检查环境变量值是否为 memory、session 或 local。若退出后请求仍携带旧令牌,通常是请求层缓存了字符串,而不是每次发送前调用 getAccessToken()。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理访问令牌

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

登录哪都通