Vue / 系统课时
管理访问令牌
管理访问令牌
登录接口返回访问令牌后,前端需要用统一方式保存、读取和清理它。本课将封装一个可切换存储策略的令牌模块,并说明内存、sessionStorage 与 localStorage 在安全性、刷新恢复和使用体验上的差异。
学习目标
- 封装访问令牌的保存、获取和清理接口
- 根据会话需求选择内存、会话存储或本地存储
- 避免令牌残留、空值写入和多处直接操作存储
先确定存储策略
访问令牌放在哪里,决定了页面刷新后是否仍保持登录,也影响令牌被脚本读取的风险。三种常见方案没有绝对优劣,应按业务场景选择。
| 方案 | 页面刷新后 | 关闭标签页后 | 适用场景 |
|---|---|---|---|
| 内存变量 | 丢失 | 丢失 | 高敏感后台、可静默续期的应用 |
sessionStorage |
保留 | 通常清除 | 希望单次浏览器会话保持登录 |
localStorage |
保留 | 保留 | 需要长期登录且能接受更高风险 |
以上三种方案都可能被同源恶意脚本读取,因此不能用它们替代 XSS 防护。若后端支持基于 HttpOnly Cookie 的安全会话,应优先评估由服务端管理刷新凭据。
封装令牌工具
下面的模块通过环境变量选择存储方式。业务代码只调用统一函数,不再直接读写浏览器存储,这样以后更换方案时不需要修改登录页、请求拦截器和退出逻辑。
// 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 并选择会话级存储:
printf 'VITE_TOKEN_STORAGE=session\n' > .env.development预期结果:
开发环境启动后,令牌写入 sessionStorage;刷新页面仍可读取,关闭当前标签页后会话数据被清除。修改环境变量后需要重新启动开发服务器,因为 Vite 在启动时加载环境配置。
接入登录与退出流程
登录成功时只保存后端明确返回的访问令牌;退出登录、令牌失效或用户切换账号时统一调用 clearAccessToken()。请求拦截器也只通过 getAccessToken() 获取值,避免不同模块使用不同键名或不同存储位置。
// 片段示例:依赖已实现的 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')
}预期结果:
登录成功后后续请求可读取令牌;执行退出后令牌被删除,并跳转到 /login。不要把完整用户对象、权限列表和令牌重复存入多个位置。令牌负责认证,用户资料与权限状态应由独立状态模块管理,并在退出时一起重置。
验证与常见问题
打开浏览器开发者工具,在 Application 或 Storage 面板检查对应存储项。使用内存模式时面板中不会出现令牌,这是正常现象;刷新页面后登录状态也会丢失。
若读取结果始终为 null,先确认保存和读取是否使用同一运行环境,再检查环境变量值是否为 memory、session 或 local。若退出后请求仍携带旧令牌,通常是请求层缓存了字符串,而不是每次发送前调用 getAccessToken()。