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。

多 Store 会话编排关系

下面的 sessionActions.ts 作为统一编排入口。示例假设各 Store 已提供简单的 set、reset 方法,请求模块返回明确的数据结构。

ts
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,只负责发送请求和返回数据
  • 共享类型、常量和纯函数放在独立模块,避免为复用一个常量而互相导入

验证状态没有残留

启动项目后,依次验证正常登录、初始化失败、权限收回和退出接口失败四种情况。

bash
npm run dev

预期输出:

text
VITE ready in <TIME> ms
Local: http://localhost:<PORT>/

实际端口可能不同。验收时应看到:登录初始化失败会回到未登录状态;权限更新后无权菜单和标签页被移除;退出接口失败时仍清空用户、权限、标签页和认证状态,并跳转到登录页。

还应在浏览器刷新后检查持久化状态。若主题偏好需要保留,可以继续存在;与会话绑定的用户资料、权限和动态路由必须清除或重新从服务端恢复,不能复用上一个账号的残留数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

组合多个状态模块

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

登录哪都通