Skip to content

权限规则 ​

模板使用统一的用户授权集合。菜单来自本地配置还是后端适配器,只影响路由的数据来源,不改变按钮的权限判断方式。

用户授权与加载状态 ​

AuthAdapter.getUserInfo() 返回规范化用户信息:

ts
return {
  userId: 'user-1',
  userName: '示例用户',
  roles: ['operator'],
  permissions: ['resource:read', 'resource:edit']
}
  • permissions 是标准操作权限集合;显式 [] 表示没有操作权限。
  • 兼容旧 buttons 字段:仅在未提供 permissions 时作为输入,两者不会合并。
  • 角色与操作权限独立,不根据 R_SUPER 等角色名自动授予全部操作权限。
  • permissionsReady 独立表示用户信息是否已成功加载,空角色不代表未加载。
  • 用户信息、权限和加载状态不持久化;刷新后重新获取,新建会话及退出时立即清空。

后端若将已授权按钮放在菜单中,由项目适配层提取并转换为用户 permissions。模板不会把本地路由 authList 自动转换为授权。

统一判断入口 ​

ts
import { usePermission } from '@/hooks'

const { ready, hasPermission, hasAllPermissions, hasRole, hasAllRoles } = usePermission()
调用含义
hasPermission('resource:edit')检查单个操作权限
hasPermission(['resource:read', 'resource:edit'])满足任一项
hasAllPermissions(['resource:read', 'resource:edit'])全部满足
hasRole(['operator', 'auditor'])满足任一角色
hasAllRoles(['operator', 'auditor'])全部角色满足

权限未加载时返回 false。空字符串、空数组或包含空值的要求视为配置错误,返回 false,开发环境发出提示。无权限限制的普通按钮不要绑定权限指令。

默认仅将精确的 *:*:* 视为操作权限通配符,可在 src/config/index.ts 的 accessControl.wildcardPermission 中修改,或设为 false 关闭。它不绕过角色限制,也不支持隐式的 resource:* 前缀匹配。

指令与业务禁用条件 ​

vue
<ElButton v-permission="'resource:edit'">编辑</ElButton>
<ElButton v-permission.all="['resource:read', 'resource:edit']">处理</ElButton>
<ElButton v-permission.disabled="'resource:approve'">审批</ElButton>
<section v-roles="'auditor'">审计区域</section>
<ElButton :disabled="!hasPermission('resource:execute') || taskRunning">执行</ElButton>

指令和 Hook 共用相同的判断逻辑。默认隐藏节点,权限恢复后恢复原节点;.disabled 保留按钮并禁止操作。绑定值、用户授权或角色变化都会触发重新判断,组件卸载时停止监听。

业务状态继续由页面控制,获得权限不会覆盖业务自身的禁用条件。复杂的按钮禁用条件优先像上例一样通过 :disabled 显式组合。

useAuth().hasAuth() 和 v-auth 保留兼容入口,但统一读取用户授权,不再根据访问模式或路由 authList 切换来源。

页面与隐藏详情页 ​

ts
{
  path: 'detail/:id',
  name: 'ResourceDetail',
  component: '/resource/detail',
  meta: {
    title: '资源详情',
    isHide: true,
    activePath: '/resource/list',
    permissions: ['resource:read']
  }
}
  • 动态路由始终要求登录。没有声明 roles、permissions 的页面不增加授权限制。
  • meta.roles 要求满足任一角色;meta.permissions 默认满足任一操作权限,配置 permissionMode: 'all' 可要求全部满足。
  • 显式配置 roles: [] 或 permissions: [] 会拒绝访问,省略字段才表示不增加限制。
  • 子页面同时受所有父级限制约束;isHide、activePath 只影响展示,不授予访问权限。
  • 访问路径必须匹配已声明路由,拥有 /resource 不会自动获得任意 /resource/... 地址的访问权。
  • 菜单和注册路由随授权变化更新。撤销当前页权限后进入 403;获得权限后可以重新访问。
  • 静态公开页用于登录和错误恢复;项目新增需要登录的静态页应声明 requiresAuth: true,也可声明角色、操作权限限制。

空菜单与恢复 ​

用户信息和菜单请求成功,但最终可访问菜单为空时,保留认证会话并展示“尚未分配访问权限”。不会因此退出登录,也不会误报 500。

页面提供“重新检查”动作。项目也可调用 src/services/permission.ts 的 refreshAccess(),重新获取用户授权和后端菜单并进入可访问首页。网络错误走错误状态,认证失效仍由认证层处理。

从旧模板迁移 ​

  1. 将依赖路由 authList 的实际授权转换为用户 permissions;authList 仅保留动作名称等描述。
  2. 保留旧 buttons 输入亦可,但新适配器建议返回 permissions,不要用空数组表示“使用旧字段”。
  3. 为隐藏详情页声明权限或嵌套在带限制的父级下,不能通过 activePath 推断授权。
  4. 检查权限键是否需要项目级命名空间,避免多个页面的 edit 被意外视为同一权限。
  5. 不再依赖节点从 DOM 中移除;以用户能否看到、操作作为测试断言。

前端权限控制用户界面和导航,业务接口仍应由服务端执行鉴权。