网关每收到一个请求就 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(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 挡粗粒度入口,注解挡细粒度操作。
会话分析揪出一个真实缺陷: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-cloud-gateway 只有路由和 CORS,鉴权在每个服务重复配置。漏配一个服务的 Resource Server 配置,那个服务就是裸奔——上线前要有安全配置扫描问:微服务下权限校验放网关还是放各服务?
答:可以都做。网关做粗粒度(登录态、黑名单),各服务做细粒度(接口级角色)。Cola 的做法是薄网关加服务本地鉴权,权限数据预聚合进共享 Redis,避免热路径上的同步 RPC。
问:RBAC 为什么中间要有角色这层?
答:解耦用户和权限。权限变更只改角色定义,不用逐个改用户;用户授权只是挂角色,两边的变动互不干扰。
问:权限缓存怎么保证一致性?
答:写库后发刷新事件重算缓存,各服务订阅或定时拉取;接受短暂不一致,但要把窗口压到业务可接受范围,并给「改了没生效」提供排查手段。