← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第28章 开源项目源码精读 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

28.14.3 Cola Cloud 源码深读:RBAC 权限模型与分布式鉴权

审校 2026-09-26 · 素材来源:zcode会话《分析项目设计亮点与分布式架构》(项目源码分析)
📑 本篇章节导航 (共6节,点击直达)
场景:权限服务成了全场单点类比:小区门禁可跑示例:鉴权链路走一遍原理拆解:三层模型 + 四步鉴权踩坑清单面试怎么问

网关每收到一个请求就 RPC 调一次权限服务,权限服务被打挂,全站跟着挂。Cola Cloud 的分布式鉴权方案反其道而行:权限数据预聚合进缓存,各服务本地鉴权,快几个数量级。

前置阅读:18.2 讲过 Security 过滤器链。这篇看 RBAC 与分布式鉴权的实现。

场景:权限服务成了全场单点

微服务拆了二十个,鉴权方案是「网关统一调权限中心」。高峰期每秒上万次鉴权 RPC,权限中心 CPU 打满。更糟的是它一挂,所有服务一起 403。

问题的本质:鉴权是每个请求都要走的热路径,热路径上不该放一个同步 RPC。

类比:小区门禁

物业(权限中心)把「哪栋楼哪些业主能进」印成一本手册,提前发给每个门岗(业务服务)。

业主刷卡时,门岗翻本地手册判断放不放——不用打电话问物业。业主信息变了,物业重印手册再发一轮。

这就是缓存预聚合 + 本地鉴权:一次同步,万次本地判断。

可跑示例:鉴权链路走一遍


# 1. 登录拿 token(角色已包含在认证信息里)
POST http://{{HOST}}/oauth/token
  grant_type=password&username={{DEMO_USER}}&password={{PASS}}

# 2. 访问订单服务的删除接口(角色不足时返回 403)
DELETE http://{{HOST}}/order/api/order/{{ORDER_ID}}
  Authorization: <token占位>

第二步发生在订单服务本地:不调权限服务,只查本服务启动时从 Redis 拉取的角色映射。

原理拆解:三层模型 + 四步鉴权

RBAC 三层关系

RBAC(Role-Based Access Control,基于角色的访问控制)的核心是「用户不直接绑权限,通过角色间接获得」:


用户(User) ──N:N── 角色(Role) ──N:N── 资源(Resource/菜单)

加角色这一层的好处:授权从「给一百个人各配五十个权限」变成「配一个角色、批量挂人」。

权限数据怎么流动

源码核心在 cola-cloud-platform/cola-cloud-upm 的 SysResourceCacheService:

1. 预聚合:UPM 服务启动时把 resource、authority、role 三表全量加载,算出四个缓存视图——URL 到角色列表的映射、角色到资源树的映射等

2. 写共享 Redis:缓存按 serviceId(服务名)分组写入,订单服务只存订单相关的 URL 映射

3. 本地拉取:各业务服务通过 SecurityAccessMetadataSource 按 serviceId 取自己那份映射

4. 本地鉴权:请求到达时 AntPathRequestMatcher 匹配 URL,SecurityAccessDecisionManager 算「用户角色 ∩ URL 所需角色」,交集为空抛 AccessDeniedException

全部动作发生在各服务进程内,基于 Spring Security 标准的 FilterSecurityInterceptor(请求级安全过滤器)体系。权限变更时重算 UPM 缓存、各服务刷新本地数据即可。

一个注解搞定方法级鉴权

URL 级之外,方法级控制用注解。为什么有了 URL 拦截还要注解?因为一个 URL 可能承载多种操作粒度:同一个列表接口,普通角色只能看、管理角色能导出。URL 拦截只到「能不能进这个接口」,注解能精确到「能不能执行这个方法」。


@PreAuthorize("hasAuthority('order:delete')")
public Result<Void> delete(Long id) { ... }

Spring Security 的方法安全在 AOP 层再拦一道,和 URL 级鉴权互补:URL 挡粗粒度入口,注解挡细粒度操作。

源码里现成的 bug

会话分析揪出一个真实缺陷:SecurityAccessMetadataSource 里有这样一行:


return metadata.get(entry.getValue());  // 把 Collection 当 key 查 Map,永远查不到

应为 entry.getValue() 直接返回。这个 bug 说明缓存预聚合方案的测试难点:映射组装错了一格,单元测试很难发现,要靠集成测试打真实请求才能暴露。

菜单与按钮也是资源

RBAC 里的资源不只是 URL。Cola 的 upm 模块把菜单也建成资源树:目录、页面、按钮各占一个节点,叶子节点对应前端一个操作按钮。

这样前后端权限就统一成了一套数据:后端拿 URL 资源做接口拦截,前端拿菜单资源树渲染导航——用户没权限的菜单干脆不出现。权限分配界面因此变成一棵可勾选的树,管理员勾「订单管理员」能看到哪些菜单、能点哪些按钮,直观且不易配错。

注意一个细节:前端隐藏菜单只是体验优化,不是安全边界。真正的拦截永远在后端接口上,用浏览器开发工具绕过前端直接调接口,必须被 Resource Server 挡住。判断一个权限系统做得对不对,就看「把前端代码全删掉、直接裸调接口」还能不能守住——守不住的就是纸糊的权限。

拿当前用户的统一入口

框架还提供了 SecurityUtils 静态门面(Facade,给复杂子系统一个简单入口的设计模式):取当前用户、取租户 ID、判断是否有某权限,全框架统一走它,业务代码不直接碰 SecurityContext。

好处是收敛:哪天底层从 Session 换成 OAuth2、从 Redis 换成 JWT,只改门面一处,几百处业务代码不用动。反之,如果业务代码到处直接读 SecurityContext,一次底层升级就是一场全库搜索的灾难。

踩坑清单

面试怎么问

问:微服务下权限校验放网关还是放各服务?

答:可以都做。网关做粗粒度(登录态、黑名单),各服务做细粒度(接口级角色)。Cola 的做法是薄网关加服务本地鉴权,权限数据预聚合进共享 Redis,避免热路径上的同步 RPC。

问:RBAC 为什么中间要有角色这层?

答:解耦用户和权限。权限变更只改角色定义,不用逐个改用户;用户授权只是挂角色,两边的变动互不干扰。

问:权限缓存怎么保证一致性?

答:写库后发刷新事件重算缓存,各服务订阅或定时拉取;接受短暂不一致,但要把窗口压到业务可接受范围,并给「改了没生效」提供排查手段。