知序
返回
保存草稿
发布
H1
H2
H3
1
2
3
Excalidraw 图
AI 写作
AI 优化
目录
输入内容后显示目录
Markdown
# 31 - RBAC 权限系统设计 > 导读:读完你能讲清一套后台权限系统的 RBAC 模型、接口鉴权实现、数据权限分层与权限缓存策略。适合准备系统设计面试或正为后台管理系统设计权限模块的后端同学。 ## 一、先建立全局认知 ### Q:这套权限系统要解决什么问题? A:需求是给后台管理系统做权限控制,要同时满足三件事:不同角色看到不同菜单、能操作不同功能、只能看到自己负责的数据。举例来说,"区域经理"只能看到自己区域的订单,"客服"只能查看不能修改。 难点在于"权限"其实有两层:**功能权限**(能不能进这个菜单、点这个按钮)和**数据权限**(能看哪些数据)。很多系统只做了前者,结果客服能查到全公司的订单。面试时能把这两层分开讲,是加分项。 术语先行: - RBAC(Role-Based Access Control,基于角色的访问控制):用户不直接绑权限,而是通过"角色"这个中间层间接获得权限。 - 数据权限(Data Scope):同样一个查询接口,不同角色看到的数据行范围不同(全部/本部门/仅本人)。 ### Q:RBAC 模型长什么样? A:核心链路是"用户 → 角色 → 权限",用户与角色、角色与权限都是多对多:  *图:用户、角色、权限两两之间多对多* ``` 核心概念:用户 → 角色 → 权限 用户(User):系统使用者 角色(Role):权限的集合(如管理员、运营、客服) 权限(Permission):具体的操作(如 user:create、order:view) 关系: 用户 ←多对多→ 角色 ←多对多→ 权限 示例: 张三 → [运营角色] → [order:view, order:export, product:edit] 李四 → [客服角色] → [order:view, user:view] 王五 → [管理员] → [*:*](所有权限) ``` 为什么要引入"角色"这层:如果用户直接绑权限,几十个用户几百个权限会变成一张巨大的关系表,且无法批量管理。角色把"人"和"权限点"解耦,改权限只需改角色。代价是权限判断多了一跳,需要缓存来补性能。 ---  [编辑 Excalidraw 源图](/images/java-interview-copy/system-design/31-design-permission-design-permission-rbac-model-diagram.excalidraw) ## 二、理解核心机制 ### Q:数据库怎么设计? A:五张表:三张主表(用户、角色、权限)+ 两张关联表(用户-角色、角色-权限)。注意 `sys_role` 上的 `data_scope` 字段,它就是数据权限分层的开关: ```sql -- 用户表 CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(100) NOT NULL, status TINYINT DEFAULT 1, dept_id BIGINT -- 所属部门(数据权限用) ); -- 角色表 CREATE TABLE sys_role ( id BIGINT PRIMARY KEY AUTO_INCREMENT, role_name VARCHAR(50) NOT NULL, role_key VARCHAR(50) UNIQUE NOT NULL, -- 角色标识(如 admin, operator) data_scope TINYINT DEFAULT 1 -- 数据权限范围:1全部 2本部门 3本人 ); -- 权限表(菜单 + 按钮 + API) CREATE TABLE sys_permission ( id BIGINT PRIMARY KEY AUTO_INCREMENT, parent_id BIGINT DEFAULT 0, name VARCHAR(50) NOT NULL, type TINYINT NOT NULL, -- 1 菜单 2 按钮 3 API permission_key VARCHAR(100), -- 权限标识(如 order:view, user:create) path VARCHAR(200), -- 前端路由 api_url VARCHAR(200), -- 后端接口地址 method VARCHAR(10), -- GET/POST/PUT/DELETE sort_order INT DEFAULT 0 ); -- 用户-角色关联表 CREATE TABLE sys_user_role ( user_id BIGINT NOT NULL, role_id BIGINT NOT NULL, PRIMARY KEY (user_id, role_id) ); -- 角色-权限关联表 CREATE TABLE sys_role_permission ( role_id BIGINT NOT NULL, permission_id BIGINT NOT NULL, PRIMARY KEY (role_id, permission_id) ); ``` 设计要点有三:权限表用 `type` 把"菜单/按钮/API"统一管理,`parent_id + sort_order` 支撑前端菜单树;`permission_key` 是"资源:动作"格式的鉴权标识;`data_scope` 直接挂在角色上,一个用户若有多角色,数据权限取并集(范围最大者生效,需按业务约定)。 ### Q:接口层怎么鉴权? A:两种主流做法——自定义注解 + AOP,或直接用 Spring Security。 **方案一:注解 + AOP**,自定义一个 `@RequiresPermission` 注解,由切面统一拦截校验: ```java // 自定义权限注解 @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface RequiresPermission { String value(); // 权限标识,如 "order:view" } // AOP 拦截 @Aspect @Component public class PermissionAspect { @Around("@annotation(permission)") public Object checkPermission(ProceedingJoinPoint joinPoint, RequiresPermission permission) throws Throwable { // 获取当前用户的权限列表 Set<String> userPermissions = SecurityContext.getCurrentUser().getPermissions(); // 校验权限 if (!userPermissions.contains(permission.value()) && !userPermissions.contains("*:*")) { throw new ForbiddenException("无权限: " + permission.value()); } return joinPoint.proceed(); } } // 使用 @RestController public class OrderController { @RequiresPermission("order:view") @GetMapping("/orders") public List<Order> listOrders() { ... } @RequiresPermission("order:export") @PostMapping("/orders/export") public void exportOrders() { ... } } ``` **方案二:Spring Security 集成**,用框架自带的 URL 级与方法级鉴权: ```java @Configuration @EnableGlobalMethodSecurity(prePostEnabled = true) public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers("/admin/**").hasRole("ADMIN") .antMatchers("/api/**").authenticated() .anyRequest().permitAll(); } } // 方法级别权限控制 @PreAuthorize("hasAuthority('order:view')") @GetMapping("/orders") public List<Order> listOrders() { ... } ``` 两者取舍:注解 + AOP 轻量、可控、不依赖框架版本,适合权限模型定制的系统;Spring Security 生态成熟(认证、CSRF、Session 一体),但配置较重、学习成本高。示例中的 `WebSecurityConfigurerAdapter` 在较新的 Spring Security 版本里已被标记为废弃,改为基于 `SecurityFilterChain` Bean 的配置方式,**具体写法需结合所用版本确认**。 ### Q:数据权限怎么实现? A:思路是"不改业务 SQL,由框架自动拼条件"。用 MyBatis 拦截器在 SQL 执行前根据当前用户的数据权限范围追加 `WHERE` 条件: ```java // 数据权限:不同角色看到不同范围的数据 // 区域经理只能看自己区域的订单,客服只能看自己处理的工单 // 方案:MyBatis 拦截器自动拼接 SQL 条件 @Intercepts(@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})) public class DataScopeInterceptor implements Interceptor { @Override public Object intercept(Invocation invocation) throws Throwable { StatementHandler handler = (StatementHandler) invocation.getTarget(); BoundSql boundSql = handler.getBoundSql(); // 获取当前用户的数据权限范围 UserInfo user = SecurityContext.getCurrentUser(); String dataScope = user.getDataScope(); String originalSql = boundSql.getSql(); String newSql = originalSql; switch (dataScope) { case "DEPT": // 本部门数据 newSql = originalSql + " AND dept_id = " + user.getDeptId(); break; case "SELF": // 仅本人数据 newSql = originalSql + " AND create_user = " + user.getId(); break; case "ALL": // 全部数据,不加条件 break; } // 反射修改 SQL Field sqlField = BoundSql.class.getDeclaredField("sql"); sqlField.setAccessible(true); sqlField.set(boundSql, newSql); return invocation.proceed(); } } ``` 关键取舍:好处是业务代码零侵入,新增接口自动带数据权限;代价是 SQL 被"偷偷改写",排查问题时容易困惑,且 `parent_id`、`or` 条件、子查询等复杂 SQL 拼错条件会出安全问题。替代方案是显式在 Service 层拼条件,可控但侵入业务、容易漏加。这类拦截器还要特别注意:拼接参数时必须用绑定变量而非字符串拼接,避免 SQL 注入。 ## 三、放进真实场景 ### Q:用户权限每次请求都查库吗? A:不行。权限校验发生在每个受保护接口上,是超高频读。做法是登录时加载一次并缓存到 Redis,通常设置过期时间兜底: ```java // 用户权限不能每次请求都查数据库 // 登录时加载权限,缓存到 Redis public Set<String> getUserPermissions(Long userId) { String cacheKey = "user:permissions:" + userId; // 1. 查缓存 Set<String> permissions = redis.opsForSet().members(cacheKey); if (permissions != null && !permissions.isEmpty()) { return permissions; } // 2. 查数据库 permissions = permissionMapper.selectByUserId(userId); // 3. 写缓存(过期时间 30 分钟) redis.opsForSet().add(cacheKey, permissions.toArray(new String[0])); redis.expire(cacheKey, 30, TimeUnit.MINUTES); return permissions; } // 角色权限变更时,清除相关用户的缓存 public void updateRolePermissions(Long roleId, List<Long> permissionIds) { // 更新数据库 rolePermissionMapper.deleteByRoleId(roleId); rolePermissionMapper.batchInsert(roleId, permissionIds); // 清除该角色下所有用户的权限缓存 List<Long> userIds = userRoleMapper.selectUserIdsByRoleId(roleId); userIds.forEach(uid -> redis.delete("user:permissions:" + uid)); } ``` 缓存策略的核心是"**变更即失效**":改角色权限时主动删除该角色下所有用户的缓存,而不是等 30 分钟过期。代价是如果用户量巨大,一次角色变更要删大量 key,可改为"版本号 + 本地缓存"降低 Redis 压力。 ### Q:前端菜单权限怎么返回? A:登录后由后端返回该用户可见的菜单树,前端只负责渲染: ```java // 登录后返回用户可见的菜单树 public List<MenuVO> getUserMenus(Long userId) { // 查询用户拥有的菜单权限 List<Permission> menus = permissionMapper.selectMenusByUserId(userId); // 构建树形结构 return buildMenuTree(menus, 0L); } private List<MenuVO> buildMenuTree(List<Permission> menus, Long parentId) { return menus.stream() .filter(m -> m.getParentId().equals(parentId)) .map(m -> { MenuVO vo = new MenuVO(m); vo.setChildren(buildMenuTree(menus, m.getId())); return vo; }) .sorted(Comparator.comparingInt(MenuVO::getSortOrder)) .collect(Collectors.toList()); } ``` 必须强调:**前端菜单控制只是体验,不是安全边界**。隐藏按钮挡不住直接调接口,所以后端每个接口仍必须做功能权限校验 + 数据权限过滤,二者缺一不可。 ## 四、总结与自测 ### Q:面试里怎么答这道题? A:分四点作答: 1. RBAC 核心:用户-角色-权限三张表 + 两张关联表,多对多关系 2. 接口鉴权:自定义注解 + AOP 拦截,或 Spring Security `@PreAuthorize` 3. 数据权限:MyBatis 拦截器自动拼接 SQL 条件(全部/本部门/仅本人) 4. 性能优化:权限列表缓存到 Redis,角色变更时清除相关用户缓存 ### Q:如果权限非常细粒度(如字段级别),RBAC 还够用吗? A:字段级权限可以在 RBAC 基础上扩展:权限表增加 `field_list` 字段,标记该权限可见的字段列表。查询时根据权限动态选择返回字段。如果更复杂,可以考虑 ABAC(基于属性的访问控制)——它用"主体/资源/环境属性"组合策略,比 RBAC 灵活,代价是策略管理和性能校验复杂度都更高。 ### Q:超级管理员怎么处理? A:两种方式:① 硬编码判断 `role_key = 'admin'` 跳过权限校验;② 给超级管理员分配 `*:*` 通配权限,校验时匹配通配符。推荐方式②,更灵活。方式①的代价是把特殊逻辑写死在代码里,新增角色维度时要改代码。 --- ## 自测 1. RBAC 为什么要引入"角色"这一中间层,不直接给用户分配权限? 2. 功能权限和数据权限的区别是什么?只做前者会有什么后果? 3. 数据权限用 MyBatis 拦截器自动拼 SQL 的代价是什么? 4. 角色权限变更后为什么必须主动清缓存?只靠过期时间会怎样? 5. 为什么说"前端隐藏菜单/按钮"不能作为安全边界?
预览
发布文章
添加摘要让读者更快了解文章内容
取消
确认发布
AI 写作助手
输入一个主题,AI 将为你生成一篇 Markdown 博客文章
AI 正在写作中...
取消
开始生成
AI 优化助手
描述你的修改需求,AI 将在原文基础上进行补充或微调
AI 正在优化中...
取消
开始优化
画布
从已有图里选
✕
图名
保存后生成 /images/excalidraw/<图名>.svg(只能用字母、数字、短横线、下划线、点)
取消
保存并插入