Vue / 系统课时

创建用户状态

创建用户状态

用户状态贯穿登录、权限控制、页面展示和退出流程。本课将创建独立的用户 Store,集中保存用户资料、角色与权限,并用加载、失败回滚和清空动作保证状态始终可预测。

学习目标

  • 使用 Pinia 保存用户资料、角色和权限
  • 封装加载用户信息与清空状态的 action
  • 处理重复请求、加载失败和退出后的状态回收

定义用户状态模型

用户 Store 至少需要区分三类信息:用户资料、角色集合和权限集合。资料用于头像与名称展示,角色用于较粗粒度的身份判断,权限用于按钮或功能级控制。不要把接口原始响应整体塞进 Store,应只保留前端真正使用的字段。

还需要记录 loading 和 loaded。loading 防止短时间内重复请求,loaded 表示当前会话是否已经完成用户初始化。两者含义不同,不能只用一个布尔值代替。

实现用户 Store

下面示例先用 fetch 封装当前用户接口,再由 Store 通过 loadUser 统一加载资料、角色和权限,并通过 clearUser 在退出登录或令牌失效时恢复初始状态。

ts
// src/api/user.ts
export interface UserProfile {
  id: string
  name: string
  avatarUrl: string
}

export interface CurrentUserResponse {
  profile: UserProfile
  roles: string[]
  permissions: string[]
}

export async function getCurrentUser(): Promise<CurrentUserResponse> {
  const response = await fetch('/api/users/me', {
    credentials: 'include'
  })

  if (!response.ok) {
    throw new Error(`加载用户信息失败:${response.status}`)
  }

  return response.json() as Promise<CurrentUserResponse>
}

// src/stores/modules/user.ts
import { computed, ref } from 'vue'
import { defineStore } from 'pinia'
import {
  getCurrentUser,
  type UserProfile
} from '@/api/user'

export const useUserStore = defineStore('user', () => {
  const profile = ref<UserProfile | null>(null)
  const roles = ref<string[]>([])
  const permissions = ref<string[]>([])
  const loading = ref(false)
  const loaded = ref(false)

  const displayName = computed(() => profile.value?.name ?? '未登录用户')

  async function loadUser() {
    if (loading.value || loaded.value) return

    loading.value = true

    try {
      const data = await getCurrentUser()
      profile.value = data.profile
      roles.value = [...data.roles]
      permissions.value = [...data.permissions]
      loaded.value = true
    } catch (error) {
      clearUser()
      throw error
    } finally {
      loading.value = false
    }
  }

  function clearUser() {
    profile.value = null
    roles.value = []
    permissions.value = []
    loaded.value = false
  }

  function hasPermission(code: string) {
    return permissions.value.includes(code)
  }

  return {
    profile,
    roles,
    permissions,
    loading,
    loaded,
    displayName,
    loadUser,
    clearUser,
    hasPermission
  }
})

预期结果

text
首次调用 loadUser() 时请求当前用户接口并写入资料、角色和权限。
加载成功后 loaded 为 true,再次调用不会重复请求。
加载失败或调用 clearUser() 后,用户资料、角色和权限恢复为空。

复制数组可以避免后续代码误用接口响应中的原始引用。加载失败时先清空状态再继续抛出错误,页面或路由守卫仍可根据业务规则跳转到登录页。

在页面中读取与验证

在需要显示用户信息的页面中,使用 storeToRefs 解构响应式状态,action 则直接从 Store 实例调用。下面组件会在挂载后加载用户,并根据权限决定是否显示“新增用户”按钮。

vue
<script setup lang="ts">
import { onMounted } from 'vue'
import { storeToRefs } from 'pinia'
import { useUserStore } from '@/stores/modules/user'

const userStore = useUserStore()
const { displayName, loading } = storeToRefs(userStore)

onMounted(async () => {
  await userStore.loadUser()
})
</script>

<template>
  <section>
    <p v-if="loading">正在加载用户信息...</p>
    <p v-else>当前用户:{{ displayName }}</p>
    <button v-if="userStore.hasPermission('user:create')">
      新增用户
    </button>
  </section>
</template>

预期结果

text
请求进行中显示“正在加载用户信息...”。
请求成功后显示当前用户名称。
仅当 permissions 包含 user:create 时显示“新增用户”按钮。

不要直接解构 const { displayName } = userStore,否则可能丢失响应式联系。状态字段使用 storeToRefs,普通 action 和方法继续通过 userStore 调用。

理解加载与清空流程

用户状态生命周期

登录成功后通常只保存令牌,然后调用 loadUser 获取最新用户信息。退出登录时应先清理令牌,再调用 clearUser,最后跳转登录页。若权限接口返回 401,也应走同一清理流程,避免旧用户信息残留在页面中。

loaded 只代表当前会话已经初始化,不代表数据永久有效。切换账号、刷新令牌失败或服务端权限发生变化时,都应清空后重新加载。

关键边界

权限判断方法应只回答“是否拥有某权限”,不要在 Store 内直接控制页面跳转或弹窗。路由守卫负责访问控制,组件负责展示,用户 Store 负责提供稳定状态和查询方法。

对于持久化,也不建议把完整用户资料长期写入本地存储。令牌之外的用户信息可在刷新页面后重新请求,既能减少过期数据,也能降低敏感信息暴露范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建用户状态

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

登录哪都通