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 处理和一次登录跳转
  • 快速触发多个路由守卫时,当前用户接口仍只发送一次
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

恢复用户会话

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

登录哪都通