Vue / 系统课时
创建用户状态
创建用户状态
用户状态贯穿登录、权限控制、页面展示和退出流程。本课将创建独立的用户 Store,集中保存用户资料、角色与权限,并用加载、失败回滚和清空动作保证状态始终可预测。
学习目标
- 使用 Pinia 保存用户资料、角色和权限
- 封装加载用户信息与清空状态的 action
- 处理重复请求、加载失败和退出后的状态回收
定义用户状态模型
用户 Store 至少需要区分三类信息:用户资料、角色集合和权限集合。资料用于头像与名称展示,角色用于较粗粒度的身份判断,权限用于按钮或功能级控制。不要把接口原始响应整体塞进 Store,应只保留前端真正使用的字段。
还需要记录 loading 和 loaded。loading 防止短时间内重复请求,loaded 表示当前会话是否已经完成用户初始化。两者含义不同,不能只用一个布尔值代替。
实现用户 Store
下面示例先用 fetch 封装当前用户接口,再由 Store 通过 loadUser 统一加载资料、角色和权限,并通过 clearUser 在退出登录或令牌失效时恢复初始状态。
// 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
}
})预期结果
首次调用 loadUser() 时请求当前用户接口并写入资料、角色和权限。
加载成功后 loaded 为 true,再次调用不会重复请求。
加载失败或调用 clearUser() 后,用户资料、角色和权限恢复为空。复制数组可以避免后续代码误用接口响应中的原始引用。加载失败时先清空状态再继续抛出错误,页面或路由守卫仍可根据业务规则跳转到登录页。
在页面中读取与验证
在需要显示用户信息的页面中,使用 storeToRefs 解构响应式状态,action 则直接从 Store 实例调用。下面组件会在挂载后加载用户,并根据权限决定是否显示“新增用户”按钮。
<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>预期结果
请求进行中显示“正在加载用户信息...”。
请求成功后显示当前用户名称。
仅当 permissions 包含 user:create 时显示“新增用户”按钮。不要直接解构 const { displayName } = userStore,否则可能丢失响应式联系。状态字段使用 storeToRefs,普通 action 和方法继续通过 userStore 调用。
理解加载与清空流程

登录成功后通常只保存令牌,然后调用 loadUser 获取最新用户信息。退出登录时应先清理令牌,再调用 clearUser,最后跳转登录页。若权限接口返回 401,也应走同一清理流程,避免旧用户信息残留在页面中。
loaded 只代表当前会话已经初始化,不代表数据永久有效。切换账号、刷新令牌失败或服务端权限发生变化时,都应清空后重新加载。
关键边界
权限判断方法应只回答“是否拥有某权限”,不要在 Store 内直接控制页面跳转或弹窗。路由守卫负责访问控制,组件负责展示,用户 Store 负责提供稳定状态和查询方法。
对于持久化,也不建议把完整用户资料长期写入本地存储。令牌之外的用户信息可在刷新页面后重新请求,既能减少过期数据,也能降低敏感信息暴露范围。