Pinia Actions 统一处理权限校验与白名单过滤,将判断权集中于 store;通过 fetchPermissions 拉取并缓存角色、路由白名单、按钮码,配合持久化插件防丢失;封装 hasRole、canAccess、hasPermission 等语义化方法供组件和守卫调用;Action 内动态过滤路由(权限匹配+白名单兜底)并注册;权限变更时调用 refreshAuthState 重拉数据、清状态、刷新路由确保实时生效。

Pinia Actions 处理权限校验与白名单过滤,核心是把“判断权”交给 store,不分散在组件或路由守卫里硬编码;Action 负责统一拉取、缓存、比对和更新权限状态,同时支持动态白名单(如允许访问的路由 path、按钮 code)的加载与验证。
用 Action 统一获取并缓存权限数据
登录成功后,调用一个 async action(如 fetchPermissions)从后端拉取结构化权限信息,例如:
- 角色列表:
['admin', 'editor']
- 路由白名单:
['/dashboard', '/user/list', '/sys/log'] - 按钮权限码:
['user:add', 'order:export', 'config:edit']
这些数据存入 state 后,配合 persistedstate 插件自动持久化到 localStorage/sessionStorage,刷新页面不丢失,避免重复请求。
封装校验逻辑为可复用的 getters 和 actions
不要在每个组件里写 if (roles.includes('admin')),而是通过 store 提供语义化方法:
- getters.hasRole(role):检查当前用户是否拥有某角色
- getters.canAccess(path):判断路由 path 是否在白名单中(用于守卫拦截)
- actions.hasPermission(code):同步返回布尔值,用于 v-if 或指令内部判断按钮级权限
这些 getter/action 都基于 store 内部的 state.roles 和 state.permissionCodes 计算,响应式更新,一处改、处处生效。
在 Action 中集成白名单动态过滤
当后端返回完整路由配置(如树形菜单),可在 Action 里做两层过滤:
- 第一层:按
meta.roles或meta.permissions字段匹配用户权限,剔除无权访问的路由项 - 第二层:再对照
state.routeWhitelist做路径级白名单兜底(防前端被篡改 meta)
过滤后的路由数组传给 router.addRoute() 动态注册,确保只有真正授权的路由进入 router 实例。
权限变更时主动触发重校验
用户切换角色、登出重登、token 刷新成功等场景,不应只清空 state,而应调用类似 refreshAuthState() 的 action:
- 先清除旧权限字段(roles、codes、whitelist)
- 再重新调用
fetchPermissions() - 最后触发
router.replace()或router.go(0)强制刷新当前路由(触发守卫重走鉴权逻辑)
这样能保证权限变更即时反映在菜单、按钮、路由跳转等所有环节,避免“已删权限但还能点按钮”的问题。










