Vue / 系统课时
恢复用户会话
恢复用户会话
页面刷新后,内存中的用户信息、权限菜单和动态路由都会消失。本课将建立统一的启动恢复流程:先读取令牌,再向服务端确认身份,最后重建权限状态,并在令牌失效时安全回到未登录状态。
学习目标
- 明确令牌、用户信息与动态路由在刷新后的恢复顺序
- 实现可重复调用且不会并发请求的会话恢复方法
- 验证有效令牌、无令牌和失效令牌三种启动结果
会话恢复要恢复什么
持久化令牌只能证明浏览器保存过登录凭据,不能代表当前会话仍然有效。应用启动时应把服务端返回的当前用户作为可信来源,再根据权限生成菜单和动态路由,不能直接信任本地缓存的用户角色。
恢复流程需要覆盖三个结果:没有令牌时直接进入游客状态;令牌有效时写入用户信息并安装动态路由;请求返回 401 或网络层确认会话无效时,清除本地认证数据并停留在登录页。

实现幂等恢复入口
下面是片段示例,依赖项目中已经存在的 fetchCurrentUser、令牌工具、权限 Store 和路由实例。关键点是用同一个 Promise 合并并发调用,并通过 sessionReady 标记避免重复恢复。
ts
// src/stores/auth.ts
import { isAxiosError } from 'axios'
import { defineStore } from 'pinia'
import { ref } from 'vue'
import { fetchCurrentUser } from '@/api/auth'
import { readToken, removeToken } from '@/utils/token'
import type { UserProfile } from '@/types/auth'
export const useAuthStore = defineStore('auth', () => {
const token = ref<string | null>(readToken())
const user = ref<UserProfile | null>(null)
const sessionReady = ref(false)
let restoring: Promise<boolean> | null = null
function clearSession(): void {
removeToken()
token.value = null
user.value = null
sessionReady.value = true
}
function restoreSession(): Promise<boolean> {
if (sessionReady.value) {
return Promise.resolve(Boolean(token.value && user.value))
}
if (restoring) return restoring
restoring = (async () => {
if (!token.value) {
sessionReady.value = true
return false
}
try {
user.value = await fetchCurrentUser()
sessionReady.value = true
return true
} catch (error) {
if (isAxiosError(error) && error.response?.status === 401) {
clearSession()
return false
}
// 网络超时或 5xx 不等于会话失效,保留令牌供用户重试。
throw error
} finally {
restoring = null
}
})()
return restoring
}
return { token, user, sessionReady, restoreSession, clearSession }
})预期结果
text
有效令牌:只请求一次当前用户接口,user 被写入,restoreSession() 返回 true
无令牌:不发送当前用户请求,restoreSession() 返回 false
失效令牌:本地令牌与 user 被清空,restoreSession() 返回 false
网络故障:保留令牌并抛出错误,由启动错误页提供重试在挂载应用前重建路由
恢复动作应在 app.mount 之前完成,否则首次导航可能先命中 404。先安装 Pinia,再恢复用户、添加动态路由,最后安装 Router 并等待初始导航完成。
ts
// src/main.ts
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'
import router from './router'
import { useAuthStore } from '@/stores/auth'
import { usePermissionStore } from '@/stores/permission'
async function bootstrap(): Promise<void> {
const app = createApp(App)
const pinia = createPinia()
app.use(pinia)
const authStore = useAuthStore(pinia)
const permissionStore = usePermissionStore(pinia)
const restored = await authStore.restoreSession()
if (restored && authStore.user) {
permissionStore.installRoutes(router, authStore.user.permissions)
}
app.use(router)
await router.isReady()
app.mount('#app')
}
function showBootstrapError(): void {
const root = document.querySelector<HTMLDivElement>('#app')
if (root) root.textContent = '会话校验失败,请检查网络后刷新页面。'
}
void bootstrap().catch(showBootstrapError)预期结果
text
刷新受保护页面时,动态路由会在首次导航前完成注册;有效会话保持原页面,无效会话进入登录流程。处理启动失败与边界
网络暂时不可用不一定等于令牌失效。只有服务端明确返回 401、令牌解析失败或业务状态表示会话过期时,才应清除令牌;超时和 5xx 更适合显示重试页,避免用户被误退出。
动态路由安装也要幂等。权限 Store 应保存 router.addRoute 返回的移除函数,重复恢复前先判断是否已经安装,防止同一路由被注册多次。页面守卫只读取 sessionReady,不要再次独立请求用户信息。
验收检查
- 登录后刷新一个动态路由页面,地址、菜单高亮和用户信息均保持不变
- 删除令牌后刷新,浏览器不请求用户信息接口,并进入登录页
- 使用过期令牌刷新,只出现一次 401 处理和一次登录跳转
- 快速触发多个路由守卫时,当前用户接口仍只发送一次
按自己的节奏,确认真正理解。