Vue / 系统课时
组合多个状态模块
组合多个状态模块
登录、退出和权限更新往往同时影响认证、用户、菜单与标签页状态。若每个 Store 互相调用,项目很快会出现循环依赖和清理遗漏。本课将使用独立编排层统一协调多个 Store。
学习目标
- 将认证、用户、权限和界面状态拆分为职责清晰的 Store
- 用编排层组织登录、退出和权限刷新顺序
- 避免 Store 循环依赖并彻底清理会话残留
明确各 Store 的职责
Store 应围绕稳定职责拆分,而不是围绕某个页面拆分。认证 Store 只管理会话状态,用户 Store 管理当前用户资料,权限 Store 管理角色、权限码和动态菜单,标签页 Store 管理已打开页面。
多个 Store 可以在同一业务流程中协作,但不应形成双向导入。例如认证 Store 调用权限 Store,而权限 Store 又调用认证 Store,就会让初始化顺序、测试和热更新变得不可预测。
| 模块 | 负责内容 | 不应负责 |
|---|---|---|
| Auth Store | 登录态、会话标记、令牌内存状态 | 菜单生成、标签页清理 |
| User Store | 当前用户资料 | 登录请求、路由跳转 |
| Permission Store | 权限码、角色、动态菜单 | 保存密码或令牌 |
| Tabs Store | 已打开页面与缓存页 | 判断用户是否有权限 |
使用编排层而不是相互调用
把跨 Store 的业务流程放到独立的应用服务或组合函数中。编排层可以依次调用多个 Store 和 API,但各 Store 保持单向依赖:Store 只依赖纯工具或请求模块,不直接依赖其他 Store。

下面的 sessionActions.ts 作为统一编排入口。示例假设各 Store 已提供简单的 set、reset 方法,请求模块返回明确的数据结构。
import type { Router } from 'vue-router'
import { useAuthStore } from '@/stores/auth'
import { useUserStore } from '@/stores/user'
import { usePermissionStore } from '@/stores/permission'
import { useTabsStore } from '@/stores/tabs'
import { loginApi, logoutApi, getCurrentUserApi, getPermissionsApi } from '@/api/session'
export function createSessionActions(router: Router) {
const authStore = useAuthStore()
const userStore = useUserStore()
const permissionStore = usePermissionStore()
const tabsStore = useTabsStore()
async function login(account: string, password: string) {
const session = await loginApi({ account, password })
authStore.setSession(session)
try {
const [user, permissions] = await Promise.all([
getCurrentUserApi(),
getPermissionsApi(),
])
userStore.setUser(user)
permissionStore.setPermissions(permissions)
await router.replace('/')
} catch (error) {
// 会话建立后初始化失败时必须回滚,避免留下“半登录”状态
await resetLocalSession()
throw error
}
}
async function refreshPermissions() {
const permissions = await getPermissionsApi()
permissionStore.setPermissions(permissions)
// 权限变化后移除已失效页面,防止旧标签继续访问
tabsStore.removeUnauthorized(permissionStore.canAccess)
}
async function logout() {
try {
await logoutApi()
} finally {
await resetLocalSession()
await router.replace('/login')
}
}
async function resetLocalSession() {
tabsStore.reset()
permissionStore.reset()
userStore.reset()
authStore.reset()
}
return {
login,
logout,
refreshPermissions,
resetLocalSession,
}
}这是项目片段示例,依赖对应 Store、API 模块和 Vue Router。关键点不是文件名,而是所有跨模块流程都从编排层进入,Store 之间不再互相导入。
规定登录、权限更新和退出顺序
登录应先建立服务端会话,再并行获取用户资料与权限。两项都成功后才进入后台首页;其中任一步失败,都应回滚已经写入的本地状态,避免界面误判为已登录。
权限更新不只是替换权限码,还要同步处理菜单、路由和已打开标签页。权限被收回后,旧标签页必须关闭或跳转到无权限页面,否则用户可能继续看到已缓存的业务界面。
退出流程应把“通知服务端”和“本地清理”分开处理。即使退出接口超时或返回错误,本地状态也必须在 finally 中清空,随后跳转登录页。
避免循环依赖
出现循环依赖时,先检查是否把业务流程错误地塞进了 Store。常见坏味道包括:auth.ts 导入 permission.ts,同时 permission.ts 又导入 auth.ts;或者 Store 在模块顶层立即读取另一个 Store。
可采用以下规则:
- Store 只保存本领域状态并提供原子操作,如
setUser()、setPermissions()、reset() - 跨 Store 的顺序、回滚和路由跳转放到编排层
- 请求模块不导入 Store,只负责发送请求和返回数据
- 共享类型、常量和纯函数放在独立模块,避免为复用一个常量而互相导入
验证状态没有残留
启动项目后,依次验证正常登录、初始化失败、权限收回和退出接口失败四种情况。
npm run dev预期输出:
VITE ready in <TIME> ms
Local: http://localhost:<PORT>/实际端口可能不同。验收时应看到:登录初始化失败会回到未登录状态;权限更新后无权菜单和标签页被移除;退出接口失败时仍清空用户、权限、标签页和认证状态,并跳转到登录页。
还应在浏览器刷新后检查持久化状态。若主题偏好需要保留,可以继续存在;与会话绑定的用户资料、权限和动态路由必须清除或重新从服务端恢复,不能复用上一个账号的残留数据。